vault backup: 2026-11-05 14:57:55

工具相关/Gitea部署与Obsidian自动备份.md

@@ -0,0 +1,178 @@
+# 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，即可双向自动备份。
+
+---
+
+## 八、服务器上现在跑的东西（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` |