O96u
c9c34515dd
修复设置页误清空管理域、配置与生效 URL 混淆及第三 Host 绕过隔离；加固 Settings API 与中间件，并更新文档站。
4.0 KiB
常见问题
忘记管理员密码怎么办？
能执行 docker exec 时：
docker exec pichost reset-password
# 或指定用户名
docker exec pichost reset-password 用户名
本地：npm run reset-password。详见 快速开始。
为什么后台无法重新生成 API Token？
若设置了环境变量 API_UPLOAD_TOKEN，Token 由环境变量 锁定，需修改 env 并 重启服务。见 环境变量。
图片外链显示「盗链」或无法加载？
检查 防盗链白名单（ALLOWED_REFERER_HOSTS 或设置页）。引用图片的站点域名需在白名单中；PicHost 自身域名与双域名场景下的网站域、图片域会自动放行。
双域名下为什么用 pages.dev / workers.dev / IP 也能进后台？
v1.2.2 起： 双域名开启时，PicHost 中间件会对未配置的网站域、图片域之外的 Host 返回 404（开发环境 localhost / 127.0.0.1 例外）。详见 更新日志。
若仍能访问，常见原因：
- 未启用双域名（仅配置了图片域、网站域为空）— 隔离与第三 Host 拦截均不生效
- 反代把 Host 改成管理域 — 例如 Pages/Worker 对图片域
fetch(admin…)，PicHost 看到的是管理域 - 源站裸暴露
6892— 绕过 Cloudflare 与 Nginxserver_name
处理：在设置中正确配置双域名；反代加 default server；橙云时源站只放行 CF IP；勿用 Pages/Workers 整站反代。详见 双域名分离、Cloudflare 部署 与 更新日志。
能把 PicHost 部署到 Cloudflare Workers / Pages 吗？
不能（现状）。 项目使用 node-server、SQLite、sharp 与本地 data/，需 Docker / VPS。CF 控制台「从 Git 创建 Worker」连本仓库会部署失败。
推荐：源站跑 PicHost，CF 用 橙云 DNS（含优选）+ 可选 R2 存储；不要用 Pages/Workers 反代整站。
双域名下后台能打开但缩略图裂图？
- 确认 图片域名 配置正确且反代到同一实例
- 后台请用 网站域名 打开，不要用
localhost混用 - 见 双域名分离
升级 v1.2 后图库有删不掉的记录？
可能是 孤儿索引（有记录无文件）。重启后启动同步会自动清理；也可手动删除仅索引项。见 v1.2 迁移。
遗留 data/blog/ 目录还要吗？
执行 migrate --apply 后文件已迁入 data/images/blog/。若原目录只剩空壳或非图片文件，可自行备份后删除；迁移脚本不会删除仍含非图片文件的目录。
只用对象存储需要跑 migrate 吗？
不需要。图片在桶内时跳过 CLI；启动同步主要面向本地 data/images/ 磁盘扫描。
如何替换博客里的旧图片 URL？
使用 data/mapping.json（migrate 预览时生成）批量替换旧 key。注意映射的是 存储 key，不是完整旧站 URL。见 迁移指南。
开发时如何跳过登录？
DEV_BYPASS_ACCESS=true（仅本地，勿用于生产）。正常流程请访问 /setup 创建管理员。
文档与仓库 README 哪个为准？
本 VitePress 文档站 为完整用户指南；README 保留摘要与快速开始。在线地址：https://o96u.github.io/PicHost/
GitHub 仓库 About 怎么写？
main 分支建议：
- Description：
Lightweight self-hosted image hosting — Docker, multi-user, gallery & API, local disk or S3-compatible storage. - Website：
https://o96u.github.io/PicHost/（文档站，非图床演示）
勿写「部署在 Cloudflare Pages/Workers」—— PicHost 应用跑在 Docker/VPS；cloudflare 分支在线演示为 pic.roven.cc。