update: 新增Wiki和Gitea部署记录，同步全部运维文档

2026-08-05 17:35:32 +08:00
parent 695bed03c4
commit a2ab788992
1 changed files with 147 additions and 0 deletions
@@ -0,0 +1,147 @@
+# Wiki.js 和 Gitea 部署记录（2026-08-05）
+
+## 架构
+
+```
+https://suyushi.top       → LobeHub   (Nginx → :3210)
+https://wiki.suyushi.top   → Wiki.js   (Nginx → :3000)
+https://git.suyushi.top    → Gitea     (Nginx → :3001)
+```
+
+三服务共用同一个 Postgres 实例（lobe-postgres 容器），各自独立数据库。
+
+---
+
+## Wiki.js 部署
+
+### 容器参数
+```bash
+docker run -d \
+  --name wikijs \
+  --network lobehub_lobe-network \
+  --restart unless-stopped \
+  -p 3000:3000 \
+  -e DB_TYPE=postgres \
+  -e DB_HOST=postgresql \
+  -e DB_PORT=5432 \
+  -e DB_USER=postgres \
+  -e DB_PASS="$DB_PASS" \
+  -e DB_NAME=wiki \
+  ghcr.io/requarks/wiki:2
+```
+
+### 数据库
+- 实例：现有 lobe-postgres 容器
+- 数据库名：`wiki`
+- 创建命令：`docker compose -f /lobehub/docker-compose.yml exec -T postgresql psql -U postgres -c 'CREATE DATABASE wiki;'`
+
+### Nginx 配置
+```nginx
+server {
+    listen 80;
+    server_name wiki.suyushi.top;
+    location / {
+        proxy_pass http://127.0.0.1:3000;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+}
+```
+
+### DNS
+- 类型：A 记录
+- 主机：`wiki`
+- 值：`8.210.128.95`
+
+### SSL
+```bash
+certbot --nginx -d wiki.suyushi.top --non-interactive --agree-tos --email panghusys2025@gmail.com --redirect
+```
+
+---
+
+## Gitea 部署
+
+### 容器参数
+```bash
+docker run -d \
+  --name gitea \
+  --network lobehub_lobe-network \
+  --restart unless-stopped \
+  -p 3001:3000 -p 2222:22 \
+  -e GITEA__database__DB_TYPE=postgres \
+  -e GITEA__database__HOST=postgresql:5432 \
+  -e GITEA__database__NAME=gitea \
+  -e GITEA__database__USER=postgres \
+  -e GITEA__database__PASSWD="$DB_PASS" \
+  -e GITEA__server__DOMAIN=git.suyushi.top \
+  -e GITEA__server__ROOT_URL=https://git.suyushi.top \
+  -e GITEA__server__SSH_DOMAIN=git.suyushi.top \
+  -e GITEA__server__SSH_PORT=2222 \
+  -e GITEA__server__REVERSE_PROXY_TRUSTED_PROXIES=127.0.0.1 \
+  -e GITEA__service__DISABLE_REGISTRATION=true \
+  -v /lobehub/gitea:/data \
+  gitea/gitea:latest
+```
+
+### 数据库
+- 实例：现有 lobe-postgres 容器
+- 数据库名：`gitea`
+- 创建命令：`docker compose -f /lobehub/docker-compose.yml exec -T postgresql psql -U postgres -c 'CREATE DATABASE gitea;'`
+
+### Nginx 配置
+```nginx
+server {
+    listen 80;
+    server_name git.suyushi.top;
+    client_max_body_size 100M;
+    location / {
+        proxy_pass http://127.0.0.1:3001;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+}
+```
+
+### DNS
+- 类型：A 记录
+- 主机：`git`
+- 值：`8.210.128.95`
+
+### SSL
+```bash
+certbot --nginx -d git.suyushi.top --non-interactive --agree-tos --email panghusys2025@gmail.com --redirect
+```
+
+### 管理员设置
+```bash
+# 注册账号后通过 CLI 查看用户
+docker exec -u git gitea gitea admin user list
+
+# 管理员：suyushi
+```
+
+### SSH Clone 地址格式
+```bash
+git clone ssh://git@git.suyushi.top:2222/用户名/仓库名.git
+```
+
+## 注意事项
+
+| 项目 | 注意 |
+|------|------|
+| 容器网络 | 三服务都在 `lobehub_lobe-network` 上，通过容器名互相访问 |
+| Nginx 配置路径 | `/etc/nginx/conf.d/` 下各自独立 conf 文件 |
+| 端口映射 | 3000(Wiki.js)、3001(Gitea)、3210(LobeHub) — 只对内，Nginx 对外 |
+| DNS 新增子域名 | Namesilo API 调不通时从服务器端 `curl` 调用 |
+| DNS A 记录 vs CNAME | Let's Encrypt 验证需要 A 记录，子域名不用 CNAME |