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:
@@ -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`。修改配置时建议**两边保持一致**,避免排查困难。
|
||||
|
||||
Reference in New Issue
Block a user