1Panel 安装 Wiki.js：雨云香港 VPS 上的运维知识库配置
将部署记录和故障处理集中到 Wiki.js，配置 PostgreSQL、域名、页面路径与访问权限，分别备份数据库和文件存储。
文章目录
服务器重装、数据库连接和故障处理的笔记，如果散落在个人文件夹里，换个人接手就很难找齐。Wiki.js 适合把这些资料整理成有路径、权限和历史记录的知识库。
这篇从一台新 VPS 开始，使用 1Panel 的 Wiki.js 应用模板连接 PostgreSQL，再配置域名与访问权限。服务器能运行只是第一步，文档能被正确的人找到、私有页面不会公开，才算配置完成。
服务器选择
Wiki.js 和 PostgreSQL 放在同一台机器上，我建议先给它们留出 4GB 内存。雨云购买页可选“中国香港 → 极速三网[三区] → AMD EPYC → KVM 中配版”。
2026 年 10 月 6 日，2 核 4GB、流量不限型、8Mbps 上传和 15Mbps 下载，默认 40GB SSD 云盘，加一个普通公网 IP，月付原价合计 53 元。附件多、同时运行其他服务时，还需要考虑硬盘和内存扩容。
通过 雨云入口 注册，优惠码填写 KuZhuJi。订单中的可用券、扩容费和续费价分别核对，先月付检查实际网络体验。已有 VPS 有资源余量时，也可以先用现有机器评估，不必为了一个知识库再买服务器。
通过这个入口购买，还可按雨云规则领取消费返利。2026 年 10 月 6 日，香港三区 AMD EPYC、流量不限型，选默认 40GB SSD 云盘和一个普通公网 IPv4，购买页显示：
| 配置与购买时长 | 订单金额 | 页面显示的消费返利 |
|---|---|---|
| 2 核 4GB，月付 | 53 元 | 10.6 元 |
| 2 核 4GB，年付 | 445.2 元 | 89 元 |
表中的月付金额未使用优惠券；年付为页面显示的七折价，未叠加优惠券。不同规格、购买时长和优惠条件下，返利金额会变化，下单前查看“立即购买”下方的“消费返利”。返利以积分发放，可用于产品续费，或按平台规则兑换福利、提现；它不是本次订单直接减免的金额。
安装 1Panel 与 PostgreSQL
选择 Debian 12 纯净系统，SSH 登录后，在新服务器执行：
apt update && apt upgrade -y
apt install -y curl
bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"
安装时设置面板管理员、密码、安全入口，完成所需的 Docker 安装。进面板后安装 OpenResty 和 PostgreSQL，数据库端口不开放公网。
搜索 Wiki.js，选择稳定版本。1Panel 模板支持选择数据库服务；这里选 PostgreSQL，为 Wiki.js 单独创建数据库、用户和随机密码。应用端口可以保留未占用的默认值，通过网站代理访问时不勾选外部访问。
数据库主机填写面板关联的服务，不能把容器中的 localhost 当成另一个 PostgreSQL 容器。两者应通过面板配置的内部网络连接。
用域名进入初始化
准备 wiki.example.com，添加 A 记录指向服务器公网 IPv4。在 1Panel 创建网站关联 Wiki.js，申请并开启 HTTPS。
通过最终域名打开初始化页面，设置管理员邮箱、强密码和站点地址。正式地址使用 https://wiki.example.com，避免生成带 IP 或临时端口的链接。
先创建一页“服务器接手说明”，写入软件版本、服务用途和恢复步骤。连接密码、API 密钥等凭据不要直接写入普通文档，可以记录凭据存放位置及获取方式。
页面路径和权限怎么安排
可以按维护工作安排路径，例如：
operations/backup
operations/restore
database/postgresql
network/dns
路径表达内容关系，页面标题表达具体问题。把所有文档都放进一个“其他”目录，后续通常还要重新整理；也没必要在内容很少时先建立几十个空目录。
在管理后台设置用户组、页面规则和对应权限。先考虑三种身份：管理员、普通成员、匿名访客。私有运维记录只允许指定成员阅读和编辑；准备公开的教程，再单独给匿名访客读取权限。
用普通账号打开允许和禁止的页面，再退出登录测试一次。导航里看不到页面不代表访问被禁止，需要直接访问该页 URL 验证。
公开页面的搜索与索引
知识库内部搜索和搜索引擎索引是两件事。内部文档应由权限控制访问；公开教程则需要匿名用户能够读取正文。
公开页面用能说明问题的标题，正文交代适用版本和操作条件，同一主题的前置配置、排错与恢复页面相互链接。页面移动后要检查旧地址的处理方式，不要让别人收藏的链接直接失效。
不应为了让知识库被收录，把整个站点的匿名读取权限都打开。也不要把 noindex 当成私人文档的防护措施。
数据库备份与文件存储
按实际配置同时备份 Wiki.js 的数据库、配置，以及额外使用的附件或存储服务。开启 Git 等同步模块时，先确认它同步哪些内容；页面文本同步成功，不代表用户、权限、附件和系统设置已经完整保存。
升级前保留数据库备份与应用版本信息，恢复时先用匹配版本在隔离环境启动。检查页面内容、附件、登录和权限后，再考虑切换。
如果网站返回 502，先看 Wiki.js 容器和代理目标；应用日志提示连接数据库失败，再检查 PostgreSQL 状态、内部主机名、端口和账号。不要用开放数据库公网端口来解决容器内部连接问题。