201 lines
6.1 KiB
Markdown
201 lines
6.1 KiB
Markdown
# Gitea 部署与 Obsidian 自动备份
|
||
|
||
> 完成时间：2026-11-05
|
||
> 服务器：腾讯云新加坡 43.156.118.130（Ubuntu 24.04）
|
||
> 用途：私人代码仓库 + Obsidian 笔记自动备份，替代被封的 GitHub 账号
|
||
|
||
---
|
||
|
||
## 一、Gitea 是什么
|
||
|
||
自己服务器上的私人 GitHub：存代码、记版本、能回滚。开源免费（MIT 协议），全部功能不收费。数据在自己手里，没人能封。
|
||
|
||
---
|
||
|
||
## 二、部署（Docker，一条命令）
|
||
|
||
> 注意：NewAPI 已占用 3000 端口，Gitea 改走 **3001**。
|
||
|
||
SSH 上服务器（`ssh ubuntu@43.156.118.130`，再 `sudo -i`），跑：
|
||
|
||
```bash
|
||
mkdir -p /opt/gitea
|
||
docker run -d \
|
||
--name gitea \
|
||
-p 127.0.0.1:3001:3000 \
|
||
-v /opt/gitea:/data \
|
||
--restart unless-stopped \
|
||
gitea/gitea:latest
|
||
```
|
||
|
||
检查：
|
||
|
||
```bash
|
||
docker ps --filter 'name=gitea' --format '{{.Status}} {{.Ports}}'
|
||
```
|
||
|
||
看到 `Up` 和 `127.0.0.1:3001->3000` 即成功。
|
||
|
||
**现状**：容器名 `gitea`，数据卷 `/opt/gitea`，数据库 SQLite（默认），开机自启，管理员账号 `admin`。
|
||
|
||
---
|
||
|
||
## 三、访问方式：SSH 隧道
|
||
|
||
Gitea 只绑了 `127.0.0.1`，必须走隧道访问，浏览器开 `http://localhost:3001`。
|
||
|
||
`tunnel.bat`（位于 `F:\AI\docker\cpa-deploy\tunnel.bat`）已加入 3001 转发，现有 7 个端口：
|
||
|
||
| 端口 | 用途 |
|
||
| --- | --- |
|
||
| 8317 | CPA 主 API + 管理面板 |
|
||
| 8085 / 1455 / 54545 / 51121 / 11451 | Google OAuth 授权回调端口 |
|
||
| **3001** | **Gitea** |
|
||
|
||
双击 tunnel.bat，保持窗口开着。单独开隧道时用：
|
||
|
||
```powershell
|
||
ssh -N -L 3001:127.0.0.1:3001 ubuntu@43.156.118.130
|
||
```
|
||
|
||
---
|
||
|
||
## 四、初始化（只做一次）
|
||
|
||
浏览器开 `http://localhost:3001`，安装页保持默认（数据库 SQLite3），往下翻到**管理员账号**，填用户名、密码、邮箱，点**安装 Gitea**，跳转到登录页即完成。
|
||
|
||
---
|
||
|
||
## 五、推代码：第一次踩过的两个坑
|
||
|
||
### 坑 1：Git 没设用户名，提交失败
|
||
|
||
现象：`git commit` 后提示 `nothing added to commit but untracked files present`，随后 `git push` 报 `error: src refspec main does not match any`。
|
||
|
||
原因：新电脑 Git 没配身份，提交被拦，根本没产生提交。
|
||
|
||
解决（先设身份再提交）：
|
||
|
||
```powershell
|
||
git config --global user.name "admin"
|
||
git config --global user.email "beyond1008@gmail.com"
|
||
git add .
|
||
git commit -m "first commit"
|
||
```
|
||
|
||
### 坑 2：本地分支不叫 main
|
||
|
||
现象：`git push -u origin main` 报 `error: src refspec main does not match any`（提交已成功时）。
|
||
|
||
原因：本地默认分支是 `master`，不是 `main`。
|
||
|
||
解决（改名再推）：
|
||
|
||
```powershell
|
||
git branch -M main
|
||
git push -u origin main
|
||
```
|
||
|
||
### 正常推送流程（以后每次）
|
||
|
||
```powershell
|
||
git add .
|
||
git commit -m "改了什么"
|
||
git push
|
||
```
|
||
|
||
**现有仓库**：`test`（F:\AI\docker 首次推送）、`Obsidian`（笔记库）。
|
||
|
||
---
|
||
|
||
## 六、Obsidian 自动备份（Obsidian Git 插件）
|
||
|
||
### 1. 建仓库
|
||
|
||
Gitea 里点右上角 `+` → 新建仓库，名 `Obsidian`。
|
||
|
||
### 2. 装插件
|
||
|
||
Obsidian → 设置（左下角齿轮）→ 第三方插件 → 关掉**安全模式** → 浏览 → 搜 `Vinzent` → 点 **Git**（作者 Vinzent，3.4M 下载）→ 安装 → 启用。
|
||
|
||
### 3. 笔记库初始化并推送
|
||
|
||
笔记库位置：`F:\AI\Obsidian`。在 PowerShell 里跑（隧道保持开着）：
|
||
|
||
```powershell
|
||
cd F:\AI\Obsidian
|
||
git init
|
||
git add .
|
||
git commit -m "first commit"
|
||
git remote add origin http://localhost:3001/admin/Obsidian.git
|
||
git branch -M main
|
||
git push -u origin main
|
||
```
|
||
|
||
推时填 admin 和 Gitea 密码。
|
||
|
||
### 4. 开自动备份
|
||
|
||
关掉 Obsidian 再重开 → 设置 → 第三方插件 → Git：
|
||
|
||
- **Automatic** → **Auto commit-and-sync interval (minutes)** 由 `0` 改成 `10`（0 = 关闭）
|
||
- **Sync** 里确认 **Push on commit-and-sync** 和 **Pull on commit-and-sync** 都是开着的
|
||
|
||
此后每 10 分钟自动提交并推送，写笔记不用管。
|
||
|
||
> 注意：自动推送走 `localhost:3001`，隧道必须开着。隧道关了推不上去，下次开隧道后会自动补推。
|
||
|
||
---
|
||
|
||
## 七、另一台电脑怎么下载笔记
|
||
|
||
1. 装 Git（git-scm.com）。
|
||
2. 开隧道（新建 `gitea-tunnel.bat`，双击运行，窗口保持开着）：
|
||
```bat
|
||
@echo off
|
||
ssh -N -L 3001:127.0.0.1:3001 ubuntu@43.156.118.130
|
||
pause
|
||
```
|
||
3. 克隆（进想放笔记的文件夹）：
|
||
```powershell
|
||
git clone http://localhost:3001/admin/Obsidian.git
|
||
```
|
||
填 admin 和 Gitea 密码。
|
||
4. Obsidian 里点"打开文件夹作为仓库"，选克隆下来的文件夹。
|
||
5. 同样装 Obsidian Git 插件、开 Auto commit-and-sync，即可双向自动备份。
|
||
|
||
---
|
||
|
||
## 八、常见问题：打不开 Gitea 怎么办
|
||
|
||
### 隧道窗口"不动了"是正常的
|
||
|
||
`ssh -N` 的意思是"只建隧道、不给命令行"。输完密码后窗口停住不动、没有提示符，**就是隧道通了的样子**。窗口保持开着别关，关了隧道就断了。
|
||
|
||
### 打不开 `http://localhost:3001` 的排查顺序
|
||
|
||
1. **隧道开着吗？**——tunnel.bat 窗口或单独的 3001 隧道窗口，哪个关了 3001 就断了。重新双击 tunnel.bat（新版已含 3001）。
|
||
2. **端口冲突**——如果单独的 3001 隧道窗口还开着，tunnel.bat 里的 3001 就绑不上（`bind: address already in use`）。先把所有隧道窗口都关掉，再只开一个。
|
||
3. **容器在跑吗？**——SSH 上服务器跑：
|
||
```bash
|
||
docker ps --filter 'name=gitea' --format '{{.Status}} {{.Ports}}'
|
||
```
|
||
看不到 `Up` 就是容器停了，跑 `docker start gitea`。
|
||
|
||
### 记住一条
|
||
|
||
**Gitea 只认隧道**：它只绑了服务器本机 `127.0.0.1`，外网连不上，浏览器开 `localhost:3001` 之前，隧道必须先开着。
|
||
|
||
---
|
||
|
||
## 九、服务器上现在跑的东西（2026-11-05）
|
||
|
||
| 服务 | 位置/端口 | 状态 |
|
||
| --- | --- | --- |
|
||
| Xray + Shadowsocks（梯子） | 8388，systemd 服务 `xray-ss` | 正常 |
|
||
| CPA（Gemini Pro 转 API） | Docker，127.0.0.1:8317 | 正常 |
|
||
| NewAPI | Docker，127.0.0.1:3000 | 正常 |
|
||
| Nginx | 域名 api.trivoo.website | 正常 |
|
||
| **Gitea** | **Docker，127.0.0.1:3001** | **正常** |
|
||
| 3x-ui | 已停用（`systemctl stop x-ui`），但仍开机自启 | 待处理：`sudo systemctl disable x-ui` |
|