ghcr.io/linuxserver/wikijs:amd64-version-v2.5.315

镜像名称：ghcr.io/linuxserver/wikijs 参考标签：latest

https://linuxserver.io 团队为您带来全新容器版本，具备以下特性：

• 定期及时的应用更新
• 简便的用户映射配置（PGID、PUID）
• 搭载 s6 overlay 的自定义基础镜像
• 基于公共层的每周操作系统基础更新，覆盖整个 LinuxServer.io 生态体系，最大限度减少存储空间占用、停机时间与带宽消耗
• 定期安全更新

您可以通过以下渠道联系我们：

• https://blog.linuxserver.io - 提供容器使用教程、观点分享等各类操作指南与内容。
• https://linuxserver.io/*** - 获取实时支持，与社区及开发团队即时交流。
• https://github.com/orgs/linuxserver/discussions - 在我们的社区论坛发帖交流。
• https://github.com/linuxserver - 查看所有仓库的源代码。
• https://opencollective.com/linuxserver - 欢迎通过捐款或贡献资源的方式支持我们的项目预算。

https://github.com/linuxserver/docker-wikijs

https://github.com/Requarks/wiki 是一款基于 NodeJS 构建的现代轻量型功能强大的 Wiki 应用。

支持的架构

我们利用 Docker 清单实现多平台适配能力，相关详情可参考 Docker https://distribution.github.io/distribution/spec/manifest-v2-2/#manifest-list 以及我们的https://blog.linuxserver.io/2019/02/21/the-lsio-pipeline-project/。

直接拉取 lscr.io/linuxserver/wikijs:latest 镜像即可自动获取适配您系统架构的正确版本，您也可以通过标签拉取指定架构的镜像。

该镜像支持的架构如下：

应用配置说明

请注意，数据库配置相关的环境变量仅在首次运行时生效，后续如需修改配置，您需要直接编辑 /config/config.yml 文件。

更多详情请查阅官方文档。

只读模式运行

该镜像支持以只读容器文件系统运行，相关细节请https://docs.linuxserver.io/misc/read-only/。

非 Root 用户运行

该镜像支持使用非 Root 用户运行，相关细节请https://docs.linuxserver.io/misc/non-root/。

使用方式

您可以通过 docker-compose 或 Docker 命令行快速创建该镜像的容器。

[!NOTE] 除标记为「可选」的参数外，其余所有参数均为必填项，必须提供对应值。

docker-compose（推荐，https://docs.linuxserver.io/general/docker-compose）

---
services:
  wikijs:
    image: lscr.io/linuxserver/wikijs:latest
    container_name: wikijs
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - DB_TYPE=sqlite #optional
      - DB_HOST= #optional
      - DB_PORT= #optional
      - DB_NAME= #optional
      - DB_USER= #optional
      - DB_PASS= #optional
    volumes:
      - /path/to/wikijs/config:/config
      - /path/to/data:/data
    ports:
      - 3000:3000
    restart: unless-stopped

Docker 命令行（https://docs.docker.com/engine/reference/commandline/cli/）

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

参数说明

容器通过运行时传入的参数完成配置（即上述示例中用到的参数），参数使用冒号分隔，冒号前为主机侧配置，冒号后为容器侧配置。例如 -p 8080:80 表示将容器内部的 80 端口暴露，可通过主机 IP 的 8080 端口对外访问。

从文件读取环境变量（Docker Secrets）

您可以通过特殊前缀 FILE__ 实现从文件读取任意环境变量的值。

示例用法：

-e FILE__MYVAR=/run/secrets/mysecretvariable

该配置会将环境变量 MYVAR 的值设置为文件 /run/secrets/mysecretvariable 中的内容。

应用运行 Umask 配置

我们所有的镜像均支持通过可选参数 -e UMASK=022 自定义容器内服务的默认 umask 配置。请注意 umask 不等同于 chmod，它的作用是从权限值中减去指定数值，而非添加权限。如有疑问请先阅读Umask 相关说明后再提交技术支持工单。

用户/组标识说明

使用卷挂载（-v 参数）时，主机操作系统与容器之间可能出现权限不兼容问题。我们通过支持自定义用户 PUID 和组 PGID 的方式彻底规避该问题。

只需确保主机上所有挂载目录的所有者与您指定的 PUID 对应用户完全一致，权限相关问题就会自动消失。

以上文中的 PUID=1000、PGID=1000 为例，您可以使用 id your_user 命令查询目标用户的对应值：

id your_user

典型输出示例：

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

Docker Mods

我们发布了各类 https://github.com/linuxserver/docker-mods 用于为容器扩展额外功能。当前镜像支持的 Mod 列表（如有）以及可适用于所有 LinuxServer 镜像的通用 Mod 均可通过页面动态徽章查看。

技术支持信息

• 容器运行时获取 Shell 访问权限：

docker exec -it wikijs /bin/bash

• 实时查看容器运行日志：

docker logs -f wikijs

• 查询容器版本号：

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

• 查询镜像版本号：

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

镜像更新说明

LinuxServer 大部分镜像为静态带版本号的镜像，需要更新镜像并重建容器才能升级内部的应用版本。除个别在对应 README.md 中特别说明的例外情况外，我们不建议也不支持直接在运行中的容器内升级应用。您可以查阅上文的应用配置说明确认该镜像的推荐升级方式。

以下为容器更新的具体操作步骤：

通过 Docker Compose 升级

• 更新镜像：
• 拉取所有镜像：

docker-compose pull

• 拉取指定镜像：

docker-compose pull wikijs

• 更新容器：
• 升级所有容器：

docker-compose up -d

• 升级指定容器：

docker-compose up -d wikijs

• 清理未被使用的悬空旧镜像：

docker image prune

通过 Docker Run 升级

• 更新镜像：

docker pull lscr.io/linuxserver/wikijs:latest

• 停止正在运行的容器：

docker stop wikijs

• 删除旧容器：

docker rm wikijs

• 使用之前相同的 Docker Run 参数重新创建容器（只要主机侧目录映射正确，您的 /config 目录和所有配置都将完整保留）
• 清理未被使用的悬空旧镜像：

docker image prune

镜像更新通知工具 - Diun (Docker Image Update Notifier)

[!TIP] 我们推荐使用 https://crazymax.dev/diun/ 接收镜像更新通知。其他可实现无人值守自动升级容器的工具不在我们的推荐和支持范围内。

本地自行构建镜像

如果您需要基于该镜像做本地二次开发，或自定义功能逻辑，可执行以下命令：

git clone https://github.com/linuxserver/docker-wikijs.git
cd docker-wikijs
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/wikijs:latest .

借助 lscr.io/linuxserver/qemu-static 镜像，您可以在 x86_64 硬件上构建 ARM 架构变体，反之亦然：

docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset

完成注册后，您可以通过 -f Dockerfile.aarch64 参数指定对应架构的 Dockerfile 文件进行构建。

版本更新记录

• 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 架构支持，详见https://www.linuxserver.io/blog/a-farewell-to-arm-hf。
• 21.03.23: - 恢复 git 和 openssh 软件包以支持 Git 存储后端功能。
• 21.03.23: - 创建虚拟 /etc/os-release 文件修复系统信息页面显示异常问题。
• 10.10.22: - 基础镜像重构为 Alpine 3.16，迁移至 s6v3 版本。
• 23.01.21: - 基础镜像重构为 Alpine 3.13。
• 01.06.20: - 基础镜像重构为 Alpine 3.12。
• 28.04.20: - 新增部分 NPM 模块所需的 Python 依赖，同时新增 git 依赖以支持存储模块功能。
• 14.12.19: - 首次正式发布。