专属
文档
插件
助手
邀请
顶部
快速返回页面顶部
收起
收起工具栏
轩辕镜像 官方专业版
轩辕镜像
专业版
轩辕镜像 官方专业版
轩辕镜像
专业版
首页个人中心搜索镜像

交易
充值流量我的订单
工具
提交工单页面收录一键安装
Npm 源Pip 源Homebrew 源
帮助
常见问题轩辕镜像免费版
其他
关于我们网站地图
热门搜索:
ghcr.io/linuxserver/wikijs

ghcr.io/linuxserver/wikijs:amd64-2.5.311

ghcr.iolinux/amd64amd64-2.5.311大小: 未知更新于 2026年6月6日
让 AI 帮你使用轩辕镜像? · 展开查看说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这句话即可:

请先完整阅读并严格遵守以下文档中的全部规则与要求:

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。

LinuxServer.io 团队为您带来另一个容器版本,其特点包括:

  • 定期且及时的应用更新
  • 简单的用户映射(PGID、PUID)
  • 带有 s6 overlay 的自定义基础镜像
  • 每周基础 OS 更新,在整个 LinuxServer.io 生态系统中共享通用层,以最小化空间占用、停机时间和带宽
  • 定期安全更新

您可以通过以下渠道找到我们:

  • 博客 - 关于我们容器的所有使用方法,包括操作指南、观点等更多内容!
  • *** - 与社区和团队进行实时支持/聊天。
  • Discourse - 在我们的社区论坛上发帖。
  • https://github.com/linuxserver - 查看我们所有仓库的源代码。
  • Open Collective - 欢迎通过***或为我们的预算做出贡献来支持我们

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

https://github.com/Requarks/wiki 一个基于 NodeJS 构建的现代、轻量且功能强大的维基应用。

支持的架构

我们利用 docker manifest 实现多平台支持。更多信息可从 docker https://distribution.github.io/distribution/spec/manifest-v2-2/#manifest-list 和我们的公告 此处 获取。

只需拉取 lscr.io/linuxserver/wikijs:latest 即可获取适合您架构的正确镜像,您也可以通过标签拉取特定架构的镜像。

此镜像支持的架构如下:

架构可用标签
x86-64✅amd64-
arm64✅arm64v8-

应用设置

请注意,数据库配置环境变量仅在首次运行时生效,之后您需要直接编辑 /config/config.yml 来修改设置。

更多信息请参见 官方文档。

只读操作

此镜像可在只读容器文件系统下运行。详情请 阅读文档。

非 root 用户操作

此镜像可使用非 root 用户运行。详情请 阅读文档。

使用方法

为帮助您快速从此镜像创建容器,您可以使用 docker-compose 或 docker cli。

[!NOTE] 除非参数标记为“可选”,否则均为必填项,必须提供值。

docker-compose(推荐,点击此处了解更多信息)

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

docker 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 端口访问。

参数功能
-p 3000:3000Wiki.js Web 界面端口。
-e PUID=1000用户 ID - 详见下方说明
-e PGID=1000组 ID - 详见下方说明
-e TZ=Etc/UTC指定使用的时区,详见此 列表。
-e DB_TYPE=sqlite设置为 sqlite(默认)或 postgres,取决于您希望使用的数据库引擎
-e DB_HOST=数据库主机名(仅 postgres)
-e DB_PORT=数据库端口(仅 postgres)
-e DB_NAME=数据库名称(仅 postgres)
-e DB_USER=数据库用户名(仅 postgres)
-e DB_PASS=数据库密码(仅 postgres)
-v /config持久化配置文件
-v /dataWiki.js 数据存储位置。
--read-only=true以只读文件系统运行容器。请 阅读文档。
--user=1000:1000以非 root 用户运行容器。请 阅读文档。

来自文件的环境变量(Docker secrets)

您可以通过使用特殊前缀 FILE__ 从文件设置任何环境变量。

例如:

-e FILE__MYVAR=/run/secrets/mysecretvariable

这会根据 /run/secrets/mysecretvariable 文件的内容设置环境变量 MYVAR。

运行应用的 Umask 设置

对于我们所有的镜像,您可以使用可选的 -e UMASK=022 设置来覆盖容器内服务的默认 umask 设置。 请记住,umask 不是 chmod,它基于其值减去权限,而不是添加权限。在请求支持前,请先 阅读此处 了解相关知识。

用户/组标识符

使用卷(-v 标志)时,主机 OS 和容器之间可能会出现权限问题。我们通过允许您指定用户 PUID 和组 PGID 来避免此问题。

确保主机上的任何卷目录都归您指定的同一用户所有,这样任何权限问题都会迎刃而解。

在此示例中 PUID=1000 和 PGID=1000,要查找您的 PUID 和 PGID,请使用 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%EF%BC%8C%E4%BB%A5%E5%9C%A8%E5%AE%B9%E5%99%A8%E5%86%85%E5%90%AF%E7%94%A8%E9%A2%9D%E5%A4%96%E5%8A%9F%E8%83%BD%E3%80%82%E6%AD%A4%E9%95%9C%E5%83%8F%E5%8F%AF%E7%94%A8%E7%9A%84 Mods 列表(如有)以及可应用于我们任何镜像的通用 Mods,可通过上方的动态徽章访问。

支持信息

  • 容器运行时的 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

更新信息

我们的大多数镜像是静态的、版本化的,需要更新镜像并重新创建容器才能更新内部应用。除某些例外情况(在相关 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 镜像更新通知器)

[!TIP] 我们推荐使用 Diun 接收更新通知。不推荐或支持使用其他工具自动无人值守更新容器。

本地构建

如果您想对这些镜像进行本地修改以用于开发目的或自定义逻辑:

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

ARM 变体可以在 x86_64 硬件上构建,反之亦然,使用 lscr.io/linuxserver/qemu-static:

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 架构。如 此处 公告所述。
  • 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: - 添加 python 依赖以支持某些 NPM 模块,以及 git 以支持存储模块。
  • 14.12.19: - 初始发布。

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

需要其他帮助?请查看我们的 常见问题 Docker 镜像访问常见问题解答 或 提交工单

镜像拉取常见问题

功能

免费版与专业版区别

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

登录 · 专属域名 · 配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

排错

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

DNS 超时

DNS 解析 · 网络超时

账号

失败是否计费

manifest · blob · 计费

申请开发票(企业 / 个人)

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈,见证轩辕镜像的优质服务

用户头像

oldzhang

运维工程师

Linux服务器

5

"Docker访问体验非常流畅,大镜像也能快速完成下载。"

轩辕镜像
镜像详情
...
ghcr.io/linuxserver/wikijs
博客Docker 镜像公告与技术博客
热门查看热门 Docker 镜像推荐
教程轩辕镜像功能与使用教程
安装一键安装 Docker 并配置镜像源
官方公众号:源码跳动|官方技术交流群:13763429
官方公众号:源码跳动|官方技术交流群:|问题咨询请:提交工单
商务合作:点击复制邮箱
©2024-2026 源码跳动
商务合作:点击复制邮箱Copyright © 2024-2026 杭州源码跳动科技有限公司. All rights reserved.