270 lines
9.1 KiB
Markdown
270 lines
9.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`。
|
||
|
||
---
|
||
|
||
## 三、访问方式：域名（2026-11-06 已配好）+ SSH 隧道
|
||
|
||
**域名**：**https://g.trivoo.website**，直接打开就能登录，不用开隧道。
|
||
|
||
**隧道**（备用）：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
|
||
```
|
||
|
||
---
|
||
|
||
## 四、域名是怎么配的（2026-11-06，下次照抄）
|
||
|
||
域名：**https://g.trivoo.website**。故意没用 `git` 开头——`git` 太招摇，证书透明日志一查就知道这是个 git 服务；`g` 低调一点。
|
||
|
||
**1. DNS 解析（Spaceship）**：`trivoo.website` → Advanced DNS → 加一条 A 记录，Host `g`，Value `43.156.118.130`，TTL 30 min。
|
||
|
||
**2. Nginx 反代（服务器上）**：新建 `/etc/nginx/sites-available/g.trivoo.website`，照着 `api.trivoo.website` 的结构写，`proxy_pass` 改成 `http://127.0.0.1:3001`，只留 `listen 80`：
|
||
|
||
```bash
|
||
ln -s /etc/nginx/sites-available/g.trivoo.website /etc/nginx/sites-enabled/
|
||
nginx -t && systemctl reload nginx
|
||
```
|
||
|
||
**3. 证书**：
|
||
|
||
```bash
|
||
certbot --nginx -d g.trivoo.website
|
||
```
|
||
|
||
证书有效期到 2027-02-04，Certbot 已设自动续期。
|
||
|
||
**4. 改 Gitea 的对外地址**：Gitea 配置里还记着旧地址，克隆链接会显示错。改掉并重启：
|
||
|
||
```bash
|
||
sed -i 's|ROOT_URL = http://localhost:3001/|ROOT_URL = https://g.trivoo.website/|' /opt/gitea/gitea/conf/app.ini
|
||
docker restart gitea
|
||
```
|
||
|
||
验证：浏览器打开域名能看到登录页，仓库页面的克隆地址变成 `https://g.trivoo.website/admin/仓库名.git`。
|
||
|
||
### 安全提醒
|
||
|
||
配了域名之后，登录页就挂在公网了，不再是以前的"隐身"状态。安全靠两条：**管理员密码够强**（长、随机），以及**保持更新**（Gitea 出安全补丁就及时升，Docker Copilot 一键更新）。仓库默认是私有的，不登录看不到。
|
||
|
||
### 不想用了怎么关
|
||
|
||
随时能关回隧道模式：
|
||
|
||
```bash
|
||
# 服务器上删 Nginx 配置
|
||
rm /etc/nginx/sites-enabled/g.trivoo.website
|
||
rm /etc/nginx/sites-available/g.trivoo.website
|
||
systemctl reload nginx
|
||
```
|
||
|
||
再去 Spaceship 删掉 `g` 那条解析。关完 Gitea 就回到只有隧道能进的状态，证书不用管，过期自动作废。
|
||
|
||
---
|
||
|
||
## 五、初始化（只做一次）
|
||
|
||
浏览器开 `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`，隧道必须开着。现在有了域名，可以把远程地址改成域名，**不用开隧道也能推**：
|
||
>
|
||
> ```powershell
|
||
> cd F:\AI\Obsidian
|
||
> git remote set-url origin https://g.trivoo.website/admin/Obsidian.git
|
||
> ```
|
||
>
|
||
> 改完验证一次：`git push`，能推上去就说明通了。另一台电脑克隆时也可以直接用域名地址，不用开隧道。
|
||
|
||
---
|
||
|
||
## 八、另一台电脑怎么下载笔记
|
||
|
||
现在有了域名，最简单的是直接用域名克隆，不用开隧道：
|
||
|
||
```powershell
|
||
git clone https://g.trivoo.website/admin/Obsidian.git
|
||
```
|
||
|
||
填 admin 和 Gitea 密码。然后 Obsidian 里点"打开文件夹作为仓库"，选克隆下来的文件夹，同样装 Obsidian Git 插件、开 Auto commit-and-sync，即可双向自动备份。
|
||
|
||
还想走隧道的话（备用）：
|
||
|
||
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 现在有两条路**：域名 `https://g.trivoo.website` 直接进（不用隧道），或者隧道 `localhost:3001` 进。域名打不开时先看隧道那条能不能进，分清是反代问题还是 Gitea 本身的问题。
|
||
|
||
---
|
||
|
||
## 十、服务器上现在跑的东西（2026-11-06）
|
||
|
||
| 服务 | 位置/端口 | 状态 |
|
||
| --- | --- | --- |
|
||
| Xray + Shadowsocks（梯子） | 8388，systemd 服务 `xray-ss` | 正常 |
|
||
| CPA（Gemini Pro 转 API） | Docker，127.0.0.1:8317 | **已死：Google 403 ToS 停用（2026-11-06）** |
|
||
| NewAPI | Docker，127.0.0.1:3000 | 正常（DeepSeek 渠道可用） |
|
||
| Nginx | 域名 api.trivoo.website | 正常 |
|
||
| **Gitea** | **Docker，127.0.0.1:3001；域名 https://g.trivoo.website** | **正常** |
|
||
| Docker Copilot | Docker，127.0.0.1:8080→12712；域名 https://docker.trivoo.website | 正常（2026-11-06 新装） |
|
||
| 3x-ui | 已停用（`systemctl stop x-ui`），但仍开机自启 | 待处理：`sudo systemctl disable x-ui` |
|