Wiki搭建

简介

Wiki 是一款支持多人在线编辑、保留历史版本、页面间可自由链接跳转的协作知识创作平台。

Github 上有一个开源项目就是这个,https://github.com/requarks/wiki

本文介绍如何在本地搭建一个这样的平台。

部署

简单点,采用 Docker 部署。

wiki 需要有数据库支持,如果你本地有 MySQL,敲下面的命令,创建一个 wiki 数据库。

sql 复制代码
create schema wiki collate utf8mb4_general_ci;

接着敲下面这行命令,拉镜像,并启动容器,注意数据库账号、密码更换成自己的。

shell 复制代码
docker run -d -p 8080:3000 --name wiki --restart unless-stopped -e "DB_TYPE=mysql" -e "DB_HOST=host.docker.internal" -e "DB_PORT=3306" -e "DB_USER=root" -e "DB_PASS=123456" -e "DB_NAME=wiki" ghcr.io/requarks/wiki:2

如果本地有 PostgreSQL,敲下面的命令创建一个 wiki 数据库。

sql 复制代码
create database wiki
    with owner postgres;

接着敲下面这行命令,注意数据库账号、密码更换成自己的。

shell 复制代码
docker run -d -p 8080:3000 --name wiki --restart unless-stopped -e "DB_TYPE=mysql" -e "DB_HOST=host.docker.internal" -e "DB_PORT=3306" -e "DB_USER=root" -e "DB_PASS=123456" -e "DB_NAME=wiki" ghcr.io/requarks/wiki:2

如下,跑起来了。

看下容器日志,Nothing,无事发生,没有消息就是消息。

使用

登录浏览器,访问 http://localhost:8080,如下,进入首次登录设置页面

填完,点 INSTALL 安装

进入登录页面,使用前面设置的管理员账户登录(该说不说,登录界面有格调)

登录成功,CREATE HOME PAGE(创作主页)、ADMINISTRATION (控制台)

先进入控制台,设置语言为简体中文(Chinese Simplified)

舒服了

回到主页,这回点 创建首页

这里可以选多种编辑器,我这里选 Markdown

随笔写点,点 OK

随便写点内容,点 创建

好了

其他人访问该页面是这样(看起来还不错)

新增编辑用户,可以在下面这里设置

组权限在下面这里设置

锐评

搭建完了,博主锐评一波

先说优点:

  • github 上 starts 数量最多,社区活跃,问题少;

  • 界面简洁优雅,所见即所得,大道至简,程序员会很喜欢;

  • Markdown 页面,打印出来的效果非常好;

  • 功能齐全,有用户/组/操作权限设置,多而不繁杂,刚刚好;

  • 附带功能多,除了页面还有标签、主题、存储和支持 API 访问;

缺点也有:

  • 菜单汉化(国际化)不彻底,左侧菜单翻译过来了,右侧一些小菜单没有翻译;

  • 页面分享的社区,大多是国外的软件,国内软件仅支持微博;

总结来说,瑕不掩瑜,非常 Nice 的 wiki 工具。

相关推荐
weixin_448357044 小时前
饥荒联机版欧皇模拟器WIKI
wiki·饥荒联机版·欧皇模拟器
该用户已不存在4 小时前
这9款开发工具夯爆了,用了都说好
后端·程序员·全栈
KeepPush4 小时前
Python迭代器与生成器:从原理到实战的深度解析
后端
KeepPush4 小时前
Python itertools 深度指南:用迭代器代数写出更高效的代码
后端
小蜜蜂dry5 小时前
nestjs实战-权限二:角色模块
前端·后端·nestjs
默默且听风5 小时前
Ubuntu 22 环境下 VS Code Codex 插件无法打开的排查与修复记录
后端·ai编程·vibecoding
小蜜蜂dry5 小时前
nestjs实战-权限一: 菜单模块
前端·后端·nestjs
BingoGo6 小时前
PHP 在领域驱动(DDD)设计中的核心实践
后端·php
掘金者阿豪7 小时前
终于!我的第二本书正式出版,吃透 Agentic AI 核心不踩坑
javascript·后端
二月龙7 小时前
Redis 缓存设计避坑指南:穿透、击穿、雪崩与一致性问题
后端