fix: 全面修订技术文档 — 修复 P0/P1/P2 共 16 项审查问题

P0(必须修复):
- 技术/index.md: Web 服务 NPM → Caddy,补充服务列表和域名
- 旁路由部署.md: VPS OS CentOS → Debian,补全安装命令
- 旁路由部署.md: 新增 systemd-resolved DNS 端口冲突解决步骤
- mkdocs.yml: 删除冗余 index.md 子项,空分类用简单链接
- artalk评论系统.md: docker-compose.yml 补全环境变量

P1(建议修复):
- Linux.md: 区分旁路由本机 vs 局域网其他机器两种场景
- Android.md: 移除不支持的 Clash Meta,添加私人 DNS 冲突警告
- macOS.md: 终端命令补注视说明占位符需替换
- 旅行/index.md: 添加赛里木湖 2026 游记链接
- mkdocs部署.md: 补充 Docker 网络创建、首次启动、LE 邮箱配置
- artalk评论系统.md: 修正环境变量与配置文件矛盾说明

P2(优化):
- 首页: 添加评论区说明、修正 Immich 链接为公网域名
- 旁路由部署.md: 加固有章节目录(无锚点纯文本)
- 摄影/3D打印/日记 index.md: 充实引导内容
- 新增 Immich 部署文档
- 统一 callout 风格: ?> 改为 !!! tip
- GitHub Stars 加时间限定 (截至 2026 年 6 月)
This commit is contained in:
2026-06-04 11:58:36 +08:00
parent 155b347d3f
commit 88967a238f
15 changed files with 295 additions and 61 deletions
+7 -4
View File
@@ -13,7 +13,7 @@
- **轻量**:服务器资源有限,不能上 PostgreSQL 等重型依赖
- **中文友好**:面向中文用户
对比了 3 款主流的自托管评论系统:
对比了 3 款主流的自托管评论系统(数据截至 2026 年 6 月)
| | Artalk | Waline | Twikoo |
|------|:---:|:---:|:---:|
@@ -91,6 +91,9 @@ services:
environment:
- TZ=Asia/Shanghai
- ATK_LOCALE=zh-CN
- ATK_SITE_DEFAULT=我的知识库
- ATK_SITE_URL=https://note.kurihada.com
- ATK_TRUSTED_DOMAINS=https://note.kurihada.com
networks:
- nginx
@@ -99,7 +102,7 @@ networks:
external: true
```
> 注意:需要加入 `nginx` 网络以便 Caddy 能通过容器名 `artalk` 访问。
> 注意:需要加入 `nginx` 网络以便 Caddy 能通过容器名 `artalk` 访问。`ATK_TRUSTED_DOMAINS` 限制允许跨域请求的域名,防止 CSRF。
### 1.3 启动
@@ -261,6 +264,6 @@ docker exec -it artalk ./artalk admin
`artalk.yml` 由 Docker 挂载后属主为 root,本地编辑需 `sudo`。修改后需 `docker restart artalk` 才能生效。
### 环境变量不一定映射到配置
### 环境变量与配置文件的关系
Docker Compose 中设置的 `ATK_SITE_DEFAULT``ATK_SITE_URL` 等环境变量不一定能覆盖 `artalk.yml` 中的值(取决于 Artalk 版本)。建议直接编辑 `artalk.yml` 确保生效
Artalk 2.9.x 中环境变量和 `artalk.yml` 均可生效。当前部署两种方式同时使用,`ATK_SITE_DEFAULT``ATK_SITE_URL` 在 docker-compose.yml 中设置,同时也直接写入了 `artalk.yml`。修改配置时建议**两边保持一致**,避免排查困难