ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

用 Wiki.js 管住团队知识:30 分钟部署一个私有 Wiki

用 Wiki.js 管住团队知识:30 分钟部署一个私有 Wiki 用 Wiki.js 管住团队知识30 分钟部署一个私有 Wiki【免费下载链接】wiki-Wiki.js | Next Generation Open Source Wiki项目地址: https://gitcode.com/GitHub_Trending/wiki78/wiki-新人入职第一周就问文档在哪接口说明在笔记软件里运维记录躺在群聊里。Wiki.js 是一个基于 Node.js 的私有 wiki能把这些散落的内容收拢到一个自托管的知识库里。Wiki.js 是一个 Node.js 写的 wiki 应用后端 Express GraphQL前端 Vue定位是轻量级自托管知识库。它和 Confluence 这类商业套件最大的不同是内容存储后端可插拔——你可以直接挂一个 Git 仓库每次页面编辑都会变成一次提交。最适合想把文档放在自己服务器上、又不想专门养一套 Confluence 的中小团队。跑起来拉 Wiki.js 知识库代码前先确认两项部署本身没门槛硬性要求只有两条源码方式跑需要 Node 20 以上Docker 方式跑有台装好 Docker 的机器就行。数据库支持 Postgres、MySQL、MariaDB 和 SQLiteDocker 模式下连数据库都不用单独装。一条 Docker 命令拉起 Wiki.js 知识库主推最稳的官方镜像不用克隆源码docker run -d --name wiki \ -e DB_TYPEsqlite \ -e DB_SQLITE_STORAGE/var/lib/wiki/wiki.db \ -v wiki-data:/var/lib/wiki \ -p 3000:3000 \ requarks/wiki:2SQLite 对个人和小团队够用。多人协作上生产换成 Postgres 即可在 Compose 里加一个 Postgres 容器环境变量改成DB_TYPEpostgres加连接参数。不用 Docker 的话源码本地跑多两步git clone https://gitcode.com/GitHub_Trending/wiki78/wiki- cd wiki- npm install npm run build npm start浏览器打开后先做三件事访问http://localhost:3000首次进入是初始化向导确认数据库配置上面用环境变量指定的话会自动跳过、创建管理员账号、建第一页。建页时可以在 Markdown 和富文本编辑器之间来回切换先建一个页面跑通读写再谈别的。功能拆解Git 当存储后端如果团队的痛点是文档没人敢改怕改坏这个功能值得开。管理后台存储模块选 Git、填仓库地址后每次保存都会自动提交进仓库。实际用起来最舒服的是知识库同时变成一个受版本控制的仓库diff、回滚、打包导出全是 git 命令的活儿实现可以看 server/modules/storage/git/。一页 Markdown 装下公式和图技术文档绕不开公式和图。Wiki.js 的渲染模块全是可插拔的KaTeX 公式、Mermaid 流程图、PlantUML 时序图、代码高亮后台勾上就能用。一整页 markdown 写下来渲染出来就是公式、图、高亮代码齐全的文档页。组权限细到页面级内页不让外人看、手册只让运维改。Wiki.js 的权限模型是组 × 操作每个页面可以单独指定哪些组可读、哪些组可写。你实际得到的是公开文档、内部设计、运维手册不用拆成三个系统分三组、配一张权限矩阵就全覆盖。搜索可插拔默认不依赖外部服务页面少的时候内置数据库全文搜索直接可用不用额外起服务。知识库长到几千页之后再对接 Elasticsearch、Solr 或 Algolia模块都在 server/modules/search/ 下换引擎只改配置。进阶方向想接企业 SSOserver/modules/authentication/ 下有 20 多种策略LDAP、SAML、OIDC、Okta 等后台直接启用想对接 CI/CD 或自己写扩展模块读一下 server/core/extensions.js 的扩展加载机制避坑提醒⚠️Node 17 跑 webpack 构建会报 ERR_OSSL_EVP_UNSUPPORTED。项目脚本里已经带了--openssl-legacy-provider参数自己单独调 webpack 时要手动加上Postgres 密码带等特殊字符在 Compose 里不转义会被解析成地址分隔符连库直接失败docker run 时不挂载/var/lib/wiki卷上传的附件和 SQLite 数据库在容器重建后会一起丢Wiki.js 属于装完还得花十分钟想清楚数据放哪的工具但换来的是之后几年不用迁移。先从 SQLite 单容器跑起来跑顺了再去看 Git 存储和 SSO 接入这两块。【免费下载链接】wiki-Wiki.js | Next Generation Open Source Wiki项目地址: https://gitcode.com/GitHub_Trending/wiki78/wiki-创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表