# 栖云个人服务全景清单

> 最后更新：2026-06-27  
> 作者：冯先生  
> 目的：防止遗忘，快速查阅所有服务的部署位置、访问方式、凭证

---

## 一、架构总览

```
┌─────────────────────────────────────────────────────────────┐
│                       外网访问                           │
│  nav.xybkwd.top / podcast.xybkwd.top / vault.xybkwd.top ...  │
└────────────────────────┬────────────────────────────────────┘
                         │
          ┌──────────────┴──────────────┐
          │   东京服务器 (43.163.225.30)   │
          │   Caddy 反代 + Docker 容器     │
          │   2C/4G，跑全部核心服务        │
          └──────────────┬──────────────┘
                         │ Tailscale 隧道
          ┌──────────────┴──────────────┐
          │   北京服务器 (81.70.93.78)     │
          │   Caddy 反代（独立端口）        │
          │   国内流量加速                    │
          └──────────────┬──────────────┘
                         │ Tailscale 隧道
          ┌──────────────┴──────────────┐
          │   笔记本（家庭，100.99.151.78） │
          │   Docker Desktop                 │
          │   音乐/相册/电子书              │
          └─────────────────────────────────┘
```

---

## 二、东京服务器（43.163.225.30）

### 2.1 Docker 容器

| 服务名 | 镜像 | 端口 | 域名 | 功能 |
|:---|:---|:---:|:---|:---|
| **homepage** | ghcr.io/gethomepage/homepage | 3001→80 | nav.xybkwd.top | 导航页 |
| **authelia** | authelia/authelia | 9091 | auth.xybkwd.top | 统一认证 |
| **audiobookshelf** | ghcr.io/advplyr/audiobookshelf | 13378→80 | podcast.xybkwd.top | 有声书 |
| **freqtrade** | freqtradeorg/freqtrade | 8081→8080 | 内部使用 | 量化交易 |
| **webdav** | bytemark/webdav | 8766→80 | dav.xybkwd.top | WebDAV 服务器 |
| **vaultwarden** | vaultwarden/server | 8088→80 | vault.xybkwd.top | 密码管理 |
| **memos** | neosmemo/memos | 5230→5230 | memo.xybkwd.top | 碎片笔记 |
| **halo** | halohub/halo | 8090→8090 | halo.xybkwd.top | 博客 |

### 2.2 Systemd 服务

| 服务名 | 端口 | 域名 | 功能 |
|:---|:---:|:---|:---|
| **gitea** | 3000 | gitea.xybkwd.top | Git 仓库 |
| **caddy** | 80/443 | 所有域名 | HTTPS 反代 |
| **dashboard-api** | 9000 | dashboard.xybkwd.top | 市场结构 API |
| **dashboard** | 9001 | nav.xybkwd.top/api/todos | 待办系统 |
| **kb-qa** | - | ask.xybkwd.top | 知识库 Q&A |
| **auth_proxy** | - | - | Caddy 会话认证 |
| **shadowsocks** | - | - | 代理服务 |
| **tailscaled** | - | - | Tailscale 隧道 |

### 2.3 Caddy 反代规则

```
nav.xybkwd.top        → localhost:3001 (Homepage)
auth.xybkwd.top       → localhost:9091 (Authelia)
gitea.xybkwd.top     → localhost:3000 (Gitea，需认证)
memo.xybkwd.top       → localhost:5230 (Memos)
podcast.xybkwd.top    → localhost:13378 (Audiobookshelf，无认证)
vault.xybkwd.top      → localhost:8088 (Vaultwarden，需认证)
dav.xybkwd.top        → localhost:8766 (WebDAV，需认证)
photo.xybkwd.top      → 100.99.151.78:2283 (Immich，无认证)
books.xybkwd.top      → 100.99.151.78:8083 (Calibre-Web，无认证)
halo.xybkwd.top       → localhost:8090 (Halo)
dashboard.xybkwd.top  → localhost:9000 (Dashboard，需认证)
ask.xybkwd.top        → localhost:8100 (知识库 Q&A)
brief.xybkwd.top      → /var/www/nav (静态页面)
```

---

## 三、北京服务器（81.70.93.78）

### 3.1 Caddy 反代配置

| 端口 | 反代目标 | 用途 |
|:---:|:---|:---|
| **:8080** | 100.104.225.62:8080 | Gitea 原始文件访问 |
| **:4533** | 100.99.151.78:4533 | Navidrome 音乐服务 |

### 3.2 iptables 规则

```bash
# NAT 转发
sudo iptables -t nat -A PREROUTING -p tcp --dport 4533 -j DNAT --to-destination 100.99.151.78:4533
# 允许 FORWARD
sudo iptables -A FORWARD -p tcp -d 100.99.151.78 --dport 4533 -j ACCEPT
# 持久化
sudo iptables-save | sudo tee /etc/iptables/rules.v4 > /dev/null
```

---

## 四、笔记本（家庭，100.99.151.78）

### 4.1 Docker 容器

| 服务名 | 镜像 | 端口 | 功能 |
|:---|:---|:---:|:---|
| **navidrome** | deluan/navidrome | 4533 | 音乐流媒体 |
| **calibre-web** | lscr.io/linuxserver/calibre-web | 8083 | 电子书管理 |
| **immich_server** | ghcr.io/immich-app/immich-server | 2283 | 相册备份 |
| **immich_redis** | valkey/valkey | 6379 | Immich 缓存 |
| **immich_postgres** | ghcr.io/immich-app/postgres | 5432 | Immich 数据库 |
| **immich_machine_learning** | ghcr.io/immich-app/immich-machine-learning | - | Immich AI 识别 |

### 4.2 数据目录

| 服务 | 数据目录 | 说明 |
|:---|:---|:---|
| Navidrome | D:\navidrome\data | 数据库 + 配置 |
| Navidrome | D:\我的音乐库 | 音乐文件（只读）|
| Calibre-Web | D:\calibre-web\config | 配置 + 书库 |
| Immich | D:\immich\upload | 原始照片 |
| Immich | D:\immich\thumbs | 缩略图 |

---

## 五、访问地址汇总

### 5.1 外网访问（推荐）

| 服务 | 地址 | 说明 |
|:---|:---|:---|
| 导航页 | https://nav.xybkwd.top | 所有服务的入口 |
| Gitea | https://gitea.xybkwd.top | Git 仓库 |
| 有声书 | https://podcast.xybkwd.top | Audiobookshelf |
| 密码库 | https://vault.xybkwd.top | Vaultwarden |
| 日记 | https://memo.xybkwd.top | Memos |
| 相册 | https://photo.xybkwd.top | Immich |
| 电子书 | https://books.xybkwd.top | Calibre-Web |
| 音乐 | http://81.70.93.78:4533 | Navidrome（北京 IP）|
| 博客 | https://halo.xybkwd.top | Halo |
| 仪表盘 | https://dashboard.xybkwd.top | Dashboard |
| 知识库 | https://ask.xybkwd.top | 知识库 Q&A |

### 5.2 内网访问（Tailscale）

| 服务 | 地址 | 说明 |
|:---|:---|:---|
| 音乐 | http://100.99.151.78:4533 | Navidrome（直连）|
| 相册 | http://100.99.151.78:2283 | Immich（直连）|
| 电子书 | http://100.99.151.78:8083 | Calibre-Web（直连）|

---

## 六、凭证与 Token

### 6.1 Gitea

| 字段 | 值 |
|:---|:---|
| Git Push URL | `http://fxy:7aea3932996ad4cbacfa8aa01fa9a314599df353@localhost:3000/fxy/<repo名>.git` |
| API Token | `7aea3932996ad4cbacfa8aa01fa9a314599df353` |
| 用户名 | fxy |
| 权限 | admin |

### 6.2 WebDAV（一本日记）

| 字段 | 值 |
|:---|:---|
| 服务器地址 | `https://dav.xybkwd.top` |
| 用户名 | `fxy` |
| 密码 | 见 Gitea `fxy/server-ops/credentials/diary-webdav.md` |
| 证书验证 | 关闭（自签证书）|

### 6.3 微信读书 API

| 字段 | 值 |
|:---|:---|
| API Key | `wrk-MM9aAoEnTiG51JaSK7Ix5wAA` |
| API 地址 | `https://i.weread.qq.com/api/agent/gateway` |
| 认证方式 | `Authorization: Bearer {API Key}` |

### 6.4 Server酱（微信推送）

| 字段 | 值 |
|:---|:---|
| SendKey | 见 `~/.bashrc` 或记忆文件 |
| API 地址 | `https://sctapi.ftqq.com/{SendKey}.send` |

### 6.5 Navidrome

| 字段 | 值 |
|:---|:---|
| 管理员账号 | 首次访问时注册 |
| 音乐目录 | `D:\我的音乐库` |
| 配置文件 | `D:\navidrome\docker-compose.yml` |

### 6.6 Immich

| 字段 | 值 |
|:---|:---|
| 访问地址 | `https://photo.xybkwd.top` |
| 管理员账号 | 首次访问时注册 |
| 上传目录 | `D:\immich\upload` |

---

## 七、SSH 访问

### 7.1 东京服务器

```bash
ssh -i "C:/Users/32779/Desktop/保险箱/ssh_new.pem" ubuntu@43.163.225.30
```

### 7.2 北京服务器

```bash
ssh -i "C:/Users/32779/Desktop/保险箱/BJ.pem" ubuntu@81.70.93.78
```

### 7.3 笔记本（Tailscale）

```bash
ssh -i "C:/Users/32779/Desktop/保险箱/TS.pem" ubuntu@100.99.151.78
```

---

## 八、日常运维命令

### 8.1 东京服务器

```bash
# 查看所有容器
docker ps

# 查看 Caddy 日志
sudo journalctl -u caddy -n 50

# 重启 Caddy
sudo systemctl restart caddy

# 查看 Gitea 日志
sudo journalctl -u gitea -n 50
```

### 8.2 北京服务器

```bash
# 查看 Caddy 配置
cat /etc/caddy/Caddyfile

# 重启 Caddy
sudo systemctl restart caddy

# 查看 iptables 规则
sudo iptables -t nat -L -n -v
```

### 8.3 笔记本

```bash
# 查看所有容器
docker ps

# 重启 Navidrome
cd D:\navidrome && docker compose restart

# 查看 Navidrome 日志
docker logs navidrome --tail 50
```

---

## 九、备份与恢复

### 9.1 重要目录

| 目录 | 备份频率 | 备份位置 |
|:---|:---:|:---|
| Gitea 数据 | 每日 | `fxy/server-ops` |
| Inspired 收集器 | 每 30 分钟 | `fxy/inspiration-collector` |
| 微信读书笔记 | 每小时 | `fxy/weread-notes` |
| 电子书库 | 每周 | `D:\服务器备份\calibre-web\` |
| 有声书 | 每周 | `D:\服务器备份\有声书\` |
| 照片库 | 每周 | `D:\服务器备份\immich\` |

### 9.2 恢复流程

1. **Gitea 仓库**：从 `fxy/server-ops` 克隆
2. **音乐库**：从 `D:\我的音乐库` 恢复
3. **照片库**：从 `D:\服务器备份\immich\` 恢复

---

## 十、常见问题

### 10.1 音乐服务加载不出来艺术家

**原因**：Navidrome 首次扫描需要下载艺术家图片和信息，耗时较长。

**解决**：等待 10-30 分钟，或禁用在线元数据（Settings → Library → 取消勾选 Last.fm/Spotify）。

### 10.2 北京服务器端口不通

**原因**：iptables 规则未持久化，服务器重启后丢失。

**解决**：
```bash
sudo iptables-save | sudo tee /etc/iptables/rules.v4 > /dev/null
```

### 10.3 Immich 上传失败

**原因**：Tailscale 隧道断开，或笔记本休眠。

**解决**：检查 Tailscale 状态（`tailscale status`），确保笔记本不休眠。

---

## 附录：服务依赖关系

```
用户访问
  ↓
Caddy (东京/北京)
  ↓
├─ 静态服务（直接返回）
│   ├─ Homepage (3001)
│   ├─ Brief (静态文件)
│   └─ Ask (8100)
│
├─ Docker 服务（反代到容器）
│   ├─ Audiobookshelf (13378)
│   ├─ Vaultwarden (8088)
│   ├─ Memos (5230)
│   ├─ Halo (8090)
│   └─ WebDAV (8766)
│
└─ Tailscale 服务（反代到笔记本）
    ├─ Immich (2283)
    ├─ Calibre-Web (8083)
    └─ Navidrome (4533，经北京反代)
```

---

**文档版本**：v1.0  
**下次更新**：新增服务时立即更新  
**维护者**：冯先生 + 小布主任