linuxserver/wikijs

linuxserver/wikijs Docker镜像文档

镜像概述和主要用途

https://github.com/linuxserver/docker-wikijs 是由LinuxServer.io团队构建的Docker镜像，用于运行https://github.com/Requarks/wiki%E2%80%94%E2%80%94%E4%B8%80%E4%B8%AA%E5%9F%BA%E4%BA%8ENodeJS%E5%BC%80%E5%8F%91%E7%9A%84%E7%8E%B0%E4%BB%A3%E3%80%81%E8%BD%BB%E9%87%8F%E7%BA%A7%E4%B8%94%E5%8A%9F%E8%83%BD%E5%BC%BA%E5%A4%A7%E7%9A%84wiki%E5%BA%94%E7%94%A8%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E7%BB%A7%E6%89%BF%E4%BA%86LinuxServer.io%E7%B3%BB%E5%88%97%E9%95%9C%E5%83%8F%E7%9A%84%E6%A0%B8%E5%BF%83%E4%BC%98%E5%8A%BF%EF%BC%8C%E5%8C%85%E6%8B%AC%E5%AE%9A%E6%9C%9F%E6%9B%B4%E6%96%B0%E3%80%81%E7%AE%80%E5%8C%96%E7%9A%84%E7%94%A8%E6%88%B7%E6%9D%83%E9%99%90%E7%AE%A1%E7%90%86%E3%80%81%E8%87%AA%E5%AE%9A%E4%B9%89%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E7%AD%89%EF%BC%8C%E4%B8%BA%E5%BF%AB%E9%80%9F%E9%83%A8%E7%BD%B2%E5%92%8C%E8%BF%90%E8%A1%8CWikijs%E6%8F%90%E4%BE%9B%E4%BA%86%E5%8F%AF%E9%9D%A0%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8C%96%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E3%80%82

核心功能和特性

LinuxServer.io镜像特性

• 定期应用更新：及时同步上游Wikijs版本更新
• 用户权限映射：通过PUID/PGID参数轻松配置容器内用户权限，避免主机与容器间的权限冲突
• 自定义基础镜像：基于s6 overlay构建，提供稳定的进程管理
• 高效层复用：每周基础OS更新，跨镜像共享公共层，减少存储空间占用、 downtime和带宽消耗
• 定期安全更新：及时修复基础系统和依赖组件的安全漏洞

Wikijs应用特性

• 现代Web界面，支持响应式设计
• 多数据库支持（SQLite、PostgreSQL等）
• 丰富的内容编辑功能（Markdown、可视化编辑等）
• 版本控制与历史记录
• 多用户权限管理
• 插件扩展系统

支持架构

该镜像通过Docker manifest支持多平台架构，拉取lscr.io/linuxserver/wikijs:latest即可自动匹配对应架构。也可通过标签指定特定架构：

应用设置

• 数据库配置：首次运行时，数据库相关环境变量（如DB_TYPE、DB_HOST等）会生效并生成配置文件。后续如需修改数据库设置，需直接编辑容器内的/config/config.yml文件。
• 官方文档：更多配置细节请参考Wikijs官方文档。
• 只读操作：支持以只读容器文件系统运行，详见LinuxServer.io只读文档。
• 非Root运行：支持以非root用户身份运行容器，详见LinuxServer.io非Root文档。

使用场景和适用范围

Wikijs适用于以下场景：

• 团队知识库与文档协作平台
• 个人笔记与知识管理系统
• 项目文档与API文档托管
• 内部Wiki与帮助中心
• 开源项目文档站点

使用方法和配置说明

Docker Compose（推荐）

yaml
---
services:
  wikijs:
    image: lscr.io/linuxserver/wikijs:latest
    container_name: wikijs
    environment:
      - PUID=1000               # 运行用户ID（必填）
      - PGID=1000               # 运行组ID（必填）
      - TZ=Etc/UTC              # 时区（必填，如Asia/Shanghai）
      - DB_TYPE=sqlite          # 数据库类型（可选，默认sqlite，支持postgres）
      - DB_HOST=                # 数据库主机（可选，PostgreSQL时必填）
      - DB_PORT=                # 数据库端口（可选，PostgreSQL时必填）
      - DB_NAME=                # 数据库名称（可选，PostgreSQL时必填）
      - DB_USER=                # 数据库用户（可选，PostgreSQL时必填）
      - DB_PASS=                # 数据库密码（可选，PostgreSQL时必填）
    volumes:
      - /path/to/wikijs/config:/config  # 配置文件存储（必填）
      - /path/to/data:/data             # 数据存储（必填）
    ports:
      - 3000:3000               # Web界面端口（必填）
    restart: unless-stopped

Docker CLI

bash
docker run -d \
  --name=wikijs \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e DB_TYPE=sqlite `#可选` \
  -e DB_HOST= `#可选` \
  -e DB_PORT= `#可选` \
  -e DB_NAME= `#可选` \
  -e DB_USER= `#可选` \
  -e DB_PASS= `#可选` \
  -p 3000:3000 \
  -v /path/to/wikijs/config:/config \
  -v /path/to/data:/data \
  --restart unless-stopped \
  lscr.io/linuxserver/wikijs:latest

参数说明

端口映射（-p）

环境变量（-e）

数据卷（-v）

高级参数

环境变量与Docker Secrets

支持通过文件注入环境变量，使用FILE__前缀指定文件路径，例如：

bash
-e FILE__DB_PASS=/run/secrets/db_password

容器将从/run/secrets/db_password文件中读取DB_PASS变量的值。

Umask设置

通过-e UMASK=022可自定义应用的umask值（默认022）。umask用于控制新创建文件的权限，其值为权限掩码（非直接权限值），具体规则参考umask文档。

用户/组标识符（PUID/PGID）

当使用数据卷（-v）时，主机与容器间可能存在权限冲突。通过PUID和PGID可将容器内用户映射到主机用户，确保数据卷权限一致。获取当前用户的PUID/PGID：

bash
id your_user

输出示例：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=wikijs&query=%24.mods%5B%27wikijs%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([]
https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([]

Docker Mods是用于扩展容器功能的插件，可通过上述链接查看适用于Wikijs的Mods及通用Mods。

支持信息

容器管理命令

• 进入容器shell：

  bash
  docker exec -it wikijs /bin/bash
  

• 查看实时日志：

  bash
  docker logs -f wikijs
  

• 查看容器版本：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' wikijs
  

• 查看镜像版本：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/wikijs:latest
  

更新方法

使用Docker Compose

bash
# 更新镜像
docker-compose pull wikijs

# 重启容器
docker-compose up -d wikijs

# 清理旧镜像
docker image prune

使用Docker Run

bash
# 更新镜像
docker pull lscr.io/linuxserver/wikijs:latest

# 停止并删除旧容器
docker stop wikijs && docker rm wikijs

# 重新创建容器（使用原参数）
docker run -d [原参数] lscr.io/linuxserver/wikijs:latest

# 清理旧镜像
docker image prune

镜像更新通知

推荐使用Diun监控镜像更新，不建议使用自动更新工具。

本地构建

bash
# 克隆仓库
git clone https://github.com/linuxserver/docker-wikijs.git
cd docker-wikijs

# 构建镜像
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/wikijs:latest .

# 构建ARM架构（需qemu-static）
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
docker build -f Dockerfile.aarch64 -t lscr.io/linuxserver/wikijs:arm64v8-latest .

版本历史

• 14.10.25: 基于Alpine 3.22重建
• 18.01.25: 基于Alpine 3.21重建
• 01.06.24: 基于Alpine 3.20重建
• 23.12.23: 基于Alpine 3.19重建
• 25.08.22: 基于Alpine 3.18重建
• 07.07.23: 移除armhf架构支持
• 21.03.23: 恢复git和openssh包以支持git存储；修复系统信息页面
• 10.10.22: 基于Alpine 3.16重建，迁移至s6v3
• 23.01.21: 基于Alpine 3.13重建
• 01.06.20: 基于Alpine 3.12重建
• 28.04.20: 添加python依赖（用于NPM模块）和git（用于存储模块）
• 14.12.19: 初始发布