一句话结论:Wiki.js 首启后必须依次完成 API 启用、Trust Proxy 配置、中文 locale 安装、管理员账户管理,才能支持自动化写入和多用户协作。
Wiki.js 初始化向导完成后,默认状态:
操作路径:管理后台 → API
Token 管理:
| 用途 | 建议做法 |
|---|---|
| 自动化写入 | 创建专用 token,限制权限 |
| 保存位置 | /root/.secrets/wikijs/token |
| 访问控制 | 仅本机可读(600 权限) |
操作路径:管理后台 → 安全
为什么需要:
操作路径:管理后台 → 本地化
为什么重要:
zh locale首启向导创建的账户即为 root 管理员。
操作路径:管理后台 → 用户
cuihe500@thankseveryone.topcuihe500如需修改 root 管理员密码:
admin@thankseveryone.top)| 配置项 | 操作位置 | 状态检查 |
|---|---|---|
| API 启用 | 管理 → API | 能看到 API Token 管理界面 |
| Trust Proxy | 管理 → 安全 | 开关为开启状态 |
| zh locale | 管理 → 本地化 | 显示为已启用 |
| 管理员用户 | 管理 → 用户 | 在 Administrators 组 |
TOKEN=$(cat /root/.secrets/wikijs/token)
curl -H "Authorization: Bearer $TOKEN" \
https://wiki.thankseveryone.top/graphql \
-d '{"query": "{ pages { list { id title } } }"}'
原因:API 未启用
解决:管理后台 → API → 启用 API
原因:zh locale 未安装或未启用
解决:管理后台 → 本地化 → 下载并启用简体中文
原因:Trust Proxy 未启用
解决:管理后台 → 安全 → 启用 Trust Proxy
解决:
风险:
回滚:
| 页面 | 说明 |
|---|---|
| knowledge/wikijs/index | 文档总索引 |
| knowledge/wikijs/deploy-and-connect-wiki-recorder-handbook | 完整部署手册 |
| knowledge/wiki-recorder/usage-guide | API 写入使用说明 |
| ops/2026/04/2026-04-10-wikijs-full-deployment-chain | 本次配置的操作记录 |
wikijs 初始化 API locale 账号管理 配置指南 知识库