收藏夹吃灰、微信收藏找不到、备忘录又不适合写长文——很多人的知识散落各处。Wiki.js 是开源的现代知识库系统，界面清爽、编辑器好用，最香的是它支持把文档后端接成 Git 仓库：每次保存自动提交，天然带版本历史，备份就是一次 git push。本文用一台雨云 KVM 云服务器，Docker 一把部署 Wiki.js + PostgreSQL，把个人知识库收归自己掌控。
一、先准备一台雨云 KVM 云服务器
Wiki.js 跑在 Node 上、还要配一个 PostgreSQL，比纯静态站吃资源，给 2 核 2G 体验更舒服；预算紧 1 核 2G 也能起，只是 PostgreSQL 要调小参数。想低成本起一台可以看国产高性价比云服务器，比如雨云：KVM 虚拟化、Debian/Ubuntu 镜像任选，新用户用优惠码 admin01 享五折，入门版折后约 9 元/月，支持 7 天无理由退款，拿来托管知识库很合适。挑机器可参考 VPS 怎么选不踩坑 与 新手买 VPS 先看这几个配置参数。
我选 Debian 12。基础安全按 VPS 到手第一件事做什么 走一遍，本文默认你已建好普通用户、开了 ufw。Wiki.js 默认用 3000 端口。
二、装 Docker 并拉起 Wiki.js + PostgreSQL
装 Docker：
curl -fsSL https://get.docker.com | sh
systemctl enable --now docker
建目录并写 docker-compose.yml（Wiki.js 和数据库放一起）：
mkdir -p /opt/wikijs && cd /opt/wikijs
version: "3"
services:
db:
image: postgres:16-alpine
container_name: wikijs_db
environment:
POSTGRES_DB: wiki
POSTGRES_USER: wikijs
POSTGRES_PASSWORD: 换一个强密码
volumes:
- ./db:/var/lib/postgresql/data
restart: unless-stopped
wiki:
image: requarks/wiki:latest
container_name: wiki
depends_on:
- db
ports:
- "127.0.0.1:3000:3000"
environment:
DB_TYPE: postgres
DB_HOST: db
DB_PORT: 5432
DB_NAME: wiki
DB_USER: wikijs
DB_PASS: 换一个强密码
restart: unless-stopped
端口只绑 127.0.0.1，不直接对外，下一步用 Nginx 反代。放行后浏览器用 IP:3000 也能临时进。启动：
docker compose up -d
三、初始化与管理后台
打开 http://服务器IP:3000，第一次会让你设管理员账号密码，然后进入「管理 → 搜索引擎」初始化（选默认的 PostgreSQL 全文检索即可）。「管理 → 存储后端」可把文档接成 Git 仓库——填你的 Git 地址（自己搭的 雨云 Gitea 私有仓库 也行），每次保存自动提交，版本历史和备份一步到位。
建页面在左侧「新建页面」，支持 Markdown、富文本、代码块，还能插图表。分组、标签、权限（公开/登录可见/私有）都在后台配。
四、（可选）Nginx 反代 + HTTPS
绑域名后反代到 127.0.0.1:3000，certbot 申请证书（步骤同 雨云搭建 Vaultwarden 的反代配置），外网用 https://你的域名 访问更稳更安全。
五、踩过的坑与经验
- 内存吃紧：1 核 2G 上 PostgreSQL 容易 OOM。给 PG 的
shared_buffers调小（如 128MB）、max_connections降到 20，能稳跑；或者直接上 2 核 2G。 - 数据库连不上：Wiki.js 起不来多半是
DB_PASS和 db 容器不一致，或depends_on还没等 PG 就绪。确认两边密码一致、稍等 PG 完全启动再查docker logs wiki。 - Git 后端首次同步：接 Git 后第一次保存会 push 到仓库，仓库权限没配好会报错；先用 SSH 密钥或账号令牌测通再接。
- 备份双保险：数据库卷
./db和 Git 仓库都备份一份到 雨云对象存储，服务器重装也能恢复。 - 安全基线：管理后台强密码 + HTTPS + 限制来源 IP，完整防护见 VPS 安全配置实战。
小结
Wiki.js 把「零散笔记」变成了一个结构清晰、自己托管的私有知识库，Git 后端让版本和备份不再是负担。部署就是一个 docker-compose（Wiki.js + PostgreSQL），难点在内存调优和 Git 后端配置。当知识库主机推荐雨云这类低价稳定的 KVM 机器——优惠码 admin01 五折、7 天无理由退款，试水零压力。
合规提醒：使用雨云及本文所述方案时，请遵守《网络安全法》《个人信息保护法》《数据安全法》等相关法律法规，仅用于存储和管理你本人或经授权主体的知识内容，妥善保管访问凭据，不得用于传播违法违规信息。
