Wiki.js 介绍与部署指南 整理时间2026-07-06 | ️ 部署环境Windows 10 Docker一、Wiki.js 是什么Wiki.js是一款开源、现代化、功能强大的 Wiki 知识库系统基于 Node.js 构建。特性说明⭐ GitHub Stars28,557 开源协议AGPL-3.0免费使用️ 技术栈Node.js Vue.js GraphQL️ 数据库PostgreSQL / MySQL / MariaDB / SQLite 官方地址https://js.wiki核心功能✅多种编辑器Markdown / 所见即所得 / HTML / 代码编辑器✅管理后台完整的在线管理界面无需写代码✅权限管理用户、角色、页面级权限控制✅全文搜索内置 PostgreSQL 全文搜索或 Elasticsearch✅多语言支持 40 种语言界面✅暗色模式内置亮色/暗色主题切换✅媒体管理上传图片、文件等资源✅版本历史页面修改历史可回滚✅多种存储Git / 本地文件 / S3 / Azure / Google Cloud二、系统要求硬件要求项目最低配置推荐配置CPU1 核2 核内存1 GB2 GB硬盘10 GB20 GB SSD系统Linux / Windows / macOSUbuntu 22.04软件依赖依赖要求Node.js18.x 或 20.x LTS数据库PostgreSQL 9.6推荐/ MySQL 8.0Docker可选推荐使用三、Docker 部署最简单15 分钟搞定3.1 创建 docker-compose.ymlversion:3services:# PostgreSQL 数据库db:image:postgres:15-alpinecontainer_name:wikijs-dbrestart:unless-stoppedenvironment:POSTGRES_DB:wikiPOSTGRES_USER:wikiuserPOSTGRES_PASSWORD:你的密码volumes:-db-data:/var/lib/postgresql/datahealthcheck:test:[CMD-SHELL,pg_isready -U wikiuser -d wiki]interval:10stimeout:5sretries:5# Wiki.js 应用wiki:image:requarks/wiki:2container_name:wikijs-apprestart:unless-stoppedports:-8080:3000depends_on:db:condition:service_healthyenvironment:DB_TYPE:postgresDB_HOST:dbDB_PORT:5432DB_USER:wikiuserDB_PASS:你的密码DB_NAME:wikivolumes:-wiki-data:/wiki/data/contentvolumes:db-data:wiki-data:3.2 启动服务# 进入配置文件目录cd/你的目录/# 拉取镜像并启动dockercompose up-d# 查看运行状态dockercomposeps# 查看日志dockercompose logs-f3.3 首次设置浏览器访问http://localhost:8080填写管理员邮箱和密码站点 URL 填写http://localhost:8080点击INSTALL按钮用刚设置的邮箱和密码登录四、常用管理命令操作命令启动服务docker compose up -d停止服务docker compose stop重启服务docker compose restart查看日志docker compose logs -f更新镜像docker compose pull docker compose up -d完全删除含数据docker compose down -v五、功能面板六、使用技巧6.1 切换编辑器创建/编辑页面时在右上角可以切换编辑器类型Markdown适合技术人员Visual Editor所见即所得像 Word 一样适合非技术人员HTML直接写网页代码6.2 常见问题Q添加页面后访问报错Cannot read properties of null强制刷新浏览器Ctrl Shift R确保页面内容不为空避免标题使用特殊字符重启容器docker compose restart wikiQ如何切换中文界面管理员设置 → Locale → 下载中文语言包 → 启用Q如何备份数据数据库数据存储在 Docker Volumedb-data中文档内容存储在 Docker Volumewiki-data中备份命令docker run --rm -v wikijs_db-data:/data -v /备份目录:/backup alpine tar czf /backup/wiki-backup.tar.gz -C /data .七、优缺点总结✅ 优点开源免费GitHub 28k Stars自带完整管理后台在线编辑支持所见即所得编辑器非技术人员也能用Docker 一键部署15 分钟搞定权限管理、多语言、搜索全内置❌ 缺点必须有服务器 24 小时运行不能放 CDN必须有数据库PostgreSQL/MySQL访问速度不如静态站每次查数据库前端用 Vue 2已停止维护需要定期维护升级、备份、监控 本文档基于实际部署经验整理配置文件已保存至docker-compose.yml
Wiki.js 介绍与部署指南
发布时间：2026/7/8 11:12:42
Wiki.js 介绍与部署指南 整理时间2026-07-06 | ️ 部署环境Windows 10 Docker一、Wiki.js 是什么Wiki.js是一款开源、现代化、功能强大的 Wiki 知识库系统基于 Node.js 构建。特性说明⭐ GitHub Stars28,557 开源协议AGPL-3.0免费使用️ 技术栈Node.js Vue.js GraphQL️ 数据库PostgreSQL / MySQL / MariaDB / SQLite 官方地址https://js.wiki核心功能✅多种编辑器Markdown / 所见即所得 / HTML / 代码编辑器✅管理后台完整的在线管理界面无需写代码✅权限管理用户、角色、页面级权限控制✅全文搜索内置 PostgreSQL 全文搜索或 Elasticsearch✅多语言支持 40 种语言界面✅暗色模式内置亮色/暗色主题切换✅媒体管理上传图片、文件等资源✅版本历史页面修改历史可回滚✅多种存储Git / 本地文件 / S3 / Azure / Google Cloud二、系统要求硬件要求项目最低配置推荐配置CPU1 核2 核内存1 GB2 GB硬盘10 GB20 GB SSD系统Linux / Windows / macOSUbuntu 22.04软件依赖依赖要求Node.js18.x 或 20.x LTS数据库PostgreSQL 9.6推荐/ MySQL 8.0Docker可选推荐使用三、Docker 部署最简单15 分钟搞定3.1 创建 docker-compose.ymlversion:3services:# PostgreSQL 数据库db:image:postgres:15-alpinecontainer_name:wikijs-dbrestart:unless-stoppedenvironment:POSTGRES_DB:wikiPOSTGRES_USER:wikiuserPOSTGRES_PASSWORD:你的密码volumes:-db-data:/var/lib/postgresql/datahealthcheck:test:[CMD-SHELL,pg_isready -U wikiuser -d wiki]interval:10stimeout:5sretries:5# Wiki.js 应用wiki:image:requarks/wiki:2container_name:wikijs-apprestart:unless-stoppedports:-8080:3000depends_on:db:condition:service_healthyenvironment:DB_TYPE:postgresDB_HOST:dbDB_PORT:5432DB_USER:wikiuserDB_PASS:你的密码DB_NAME:wikivolumes:-wiki-data:/wiki/data/contentvolumes:db-data:wiki-data:3.2 启动服务# 进入配置文件目录cd/你的目录/# 拉取镜像并启动dockercompose up-d# 查看运行状态dockercomposeps# 查看日志dockercompose logs-f3.3 首次设置浏览器访问http://localhost:8080填写管理员邮箱和密码站点 URL 填写http://localhost:8080点击INSTALL按钮用刚设置的邮箱和密码登录四、常用管理命令操作命令启动服务docker compose up -d停止服务docker compose stop重启服务docker compose restart查看日志docker compose logs -f更新镜像docker compose pull docker compose up -d完全删除含数据docker compose down -v五、功能面板六、使用技巧6.1 切换编辑器创建/编辑页面时在右上角可以切换编辑器类型Markdown适合技术人员Visual Editor所见即所得像 Word 一样适合非技术人员HTML直接写网页代码6.2 常见问题Q添加页面后访问报错Cannot read properties of null强制刷新浏览器Ctrl Shift R确保页面内容不为空避免标题使用特殊字符重启容器docker compose restart wikiQ如何切换中文界面管理员设置 → Locale → 下载中文语言包 → 启用Q如何备份数据数据库数据存储在 Docker Volumedb-data中文档内容存储在 Docker Volumewiki-data中备份命令docker run --rm -v wikijs_db-data:/data -v /备份目录:/backup alpine tar czf /backup/wiki-backup.tar.gz -C /data .七、优缺点总结✅ 优点开源免费GitHub 28k Stars自带完整管理后台在线编辑支持所见即所得编辑器非技术人员也能用Docker 一键部署15 分钟搞定权限管理、多语言、搜索全内置❌ 缺点必须有服务器 24 小时运行不能放 CDN必须有数据库PostgreSQL/MySQL访问速度不如静态站每次查数据库前端用 Vue 2已停止维护需要定期维护升级、备份、监控 本文档基于实际部署经验整理配置文件已保存至docker-compose.yml
)
