Wikig

镜像概述

Wikig 是一个兼具博客特性的维基系统（A blog with some wiki influences），融合了维基的协作编辑能力与博客的内容发布特性。实时网站示例：[***]

许可证信息

Wikig 源代码采用 MIT 许可证（详见 package.json），同时包含 twemoji 资源，其采用 CC-BY 4.0 许可证（基于 此提交）。

Docker 使用方法

Wikig 镜像已发布至 Docker Hub，支持通过 Docker 快速部署。

构建或拉取镜像

bash
# 本地构建镜像
$ docker build . -t wilfred/wikig

# 或直接从 Docker Hub 拉取
$ docker pull wilfred/wikig:latest

准备数据存储

创建持久化卷以保存数据库文件（确保数据持久化）：

bash
$ docker volume create wikig_storage

初始化数据库

首次使用前需初始化数据库：

bash
$ docker run -v wikig_storage:/ext -e DB_PATH=/ext/wikig.db wilfred/wikig /usr/src/app/bin/init-db

运行容器

启动 Wikig 服务，配置必要参数：

bash
$ docker run \
  -e ADMIN_PASSWORD=你的管理员密码 \
  -e SITE_NAME="我的网站" \
  -v wikig_storage:/ext \
  -e DB_PATH=/ext/wikig.db \
  -e DEBUG=wikig:* \
  --name wikig \
  -p 3000:3000 \
  -t -d \
  wilfred/wikig

核心参数说明：

• -v wikig_storage:/ext: 挂载数据卷，持久化存储数据库
• -e ADMIN_PASSWORD: 管理员密码（必填，用于后台管理）
• -e SITE_NAME: 自定义网站名称（可选）
• -e DB_PATH: 数据库文件路径（需指向卷内路径，如/ext/wikig.db）
• -p 3000:3000: 映射端口，访问http://localhost:3000即可打开网站

备份与恢复

备份数据库

通过以下步骤将数据库文件备份到本地：

1. 查看卷内数据库文件：

   bash
   $ docker run -it --rm -v wikig_storage:/vol busybox ls -l /vol
   -rw-r--r--    1 root     root         24576 Aug 13 09:41 wikig.db
   

2. 复制数据库到本地：

   bash
   # 创建临时容器挂载存储卷
   $ docker container create --name dummy -v wikig_storage:/root hello-world
   # 复制数据库文件
   $ docker cp dummy:/root/wikig.db .
   # 清理临时容器
   $ docker rm dummy
   

恢复数据库

将本地数据库文件恢复到容器：

bash
# 创建临时容器挂载存储卷
$ docker container create --name dummy -v wikig_storage:/root hello-world
# 复制本地数据库到卷内
$ docker cp wikig.db dummy:/root/wikig.db
# 清理临时容器
$ docker rm dummy

本地开发（可选）

若需本地开发调试，可执行：

bash
$ npm i
$ npm run init-db
$ npm run watch