docs: milestone V1 updated with Calibre-Web config + all lessons learned

Full today experience documented:
- Token audit: GLM 5.0 Turbo consumed 1600+ credits
- Auth proxy design & 3-service crash rollback
- Cookie + basicauth dual auth finalized
- Git-First deployment principle
- Calibre-Web deployment & 4 configuration pitfalls
- Complete debug commands and recovery steps
This commit is contained in:
fxy
2026-06-15 21:31:20 +08:00
parent a6e85c69d3
commit 5618fb7e6e

View File

@ -104,15 +104,48 @@ Caddy v2.11.4HTTPS + 路由)
回滚命令: git checkout 1a80249 -- Caddyfile 回滚命令: git checkout 1a80249 -- Caddyfile
``` ```
### server-opsauth_proxy ### server-opsauth_proxy + Calibre-Web 配置
``` ```
最新 commit: 195954c 最新 commit: a6e85c6 (Milestone V1)
消息: fix: auth_proxy Cache-Control no-cache + POST redirect fallback 回滚命令: git checkout a6e85c6 -- auth_proxy/
回滚命令: git checkout 195954c -- auth_proxy/ git checkout a6e85c6 -- milestone_v1.md
``` ```
--- ---
## 六、Calibre-Web 配置
| 项目 | 值 |
|:---|:---|
| 域名 | `books.xybkwd.top` |
| 端口 | 8083Docker |
| 镜像 | `lscr.io/linuxserver/calibre-web:latest` |
| 数据目录 | `/home/ubuntu/calibre-web/books/`(映射到容器 `/books` |
| 配置目录 | `/home/ubuntu/calibre-web/config/`(映射到容器 `/config` |
| 管理员 | `admin` / `admin123` |
| 语言 | `zh_Hans_CN`(简体中文) |
| 数据库路径 | `/books` |
| 上传功能 | 已开启 |
### Docker 启动命令
```bash
docker run -d --name=calibre-web \
-e PUID=1000 -e PGID=1000 \
-p 8083:8083 \
-v /home/ubuntu/calibre-web/config:/config \
-v /home/ubuntu/calibre-web/books:/books \
--restart unless-stopped \
lscr.io/linuxserver/calibre-web:latest
```
### Calibre-Web 踩坑记录
1. **metadata.db 必须用 calibredb 创建**,不要手动 sqlite3 CREATE TABLE
2. `config_calibre_uuid` 必须匹配 `metadata.db``library_id.uuid`
3. 上传卡死通常是 metadata.db 版本不兼容(宿主机 calibre vs 容器内)
4. 重置容器后 settings 表配置会丢失(上传、语言、标题需重新设置)
---
## 六、完全恢复步骤 ## 六、完全恢复步骤
```bash ```bash