想自建 Wiki 与知识库？Docker 部署 Tiki Wiki，浏览器就能协作

本文基于 tikiwiki/tikiwiki:27.5 与 library/mariadb:latest 镜像，Ubuntu 24.04 服务器实测（服务器 IP 192.168.1.18，访问端口 8080）

Wiki、知识库、工单、论坛、博客、Tracker 低代码……各买一套 SaaS，数据分散、费用叠加？Tiki Wiki CMS Groupware 是开源的一体化协作平台——内置功能极多，号称「功能最全的开源 Web 应用」，适合在自有服务器上 私有化部署 Wiki 与团队知识库。

Tiki 不能单容器跑生产环境，必须配套 MariaDB。本文带你用 Docker Compose 双容器一键上线：轩辕镜像加速拉取、编写 docker-compose.yml、读懂启动日志，再跟做 Web 安装向导 9 步（含 Security Precaution 数据库凭据踩坑），最后登录后台、应用公司内网 Profile——全程 Ubuntu 24.04 实测，附 18 张截图 与完整命令。

国内用户从 Docker Hub 拉取可能较慢，本文使用 轩辕镜像 加速域 docker.xuanyuan.run。官方镜像说明见 Docker Hub tikiwiki/tikiwiki，项目官网 tiki.org，源码 GitLab tikiwiki/tiki。

---

一、Tiki Wiki 是什么？

Tiki Wiki CMS Groupware（常简称 Tiki）是一款 开源、自托管的一体化 Web 应用，LGPL 许可。官方称其是「内置功能最多的 Free/Libre/Open Source Web 应用」。

典型使用场景：团队 私有 Wiki 与知识库；小公司 内网门户 + 协作；替代部分 Confluence + Jira + 论坛的多套 SaaS 组合。

部署要点：Tiki 不能单容器跑生产，须配套 MariaDB（官方 Docker 示例使用 mariadb）。本文采用 Docker Compose 双容器 + Web 安装向导（基础方案；多副本 HAProxy 扩展模式不在本文范围）。

架构示意：

text
浏览器 ──HTTP:8080──▶ Tiki 容器 (Apache + PHP 8.1)
Tiki 容器 ──3306 内网──▶ MariaDB 容器
Tiki ──命名卷──▶ files / storage / sessions 等持久化

---

二、环境要求

验证 Docker：

bash
docker --version
docker compose version

若尚未安装 Docker，可使用轩辕镜像一键脚本：

bash
bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

更多安装说明见 轩辕镜像使用手册。若 docker compose 不可用，见文末 FAQ Q1。

镜像版本对照：

---

三、拉取镜像

先拉 Tiki 主镜像，再拉 MariaDB：

bash
docker pull docker.xuanyuan.run/tikiwiki/tikiwiki:27.5
docker pull docker.xuanyuan.run/library/mariadb:latest

成功时终端显示 Status: Downloaded newer image for ...。本文实测拉取输出摘要：

text
Status: Downloaded newer image for docker.xuanyuan.run/tikiwiki/tikiwiki:27.5
Status: Downloaded newer image for docker.xuanyuan.run/library/mariadb:latest

可用 docker images 确认本地镜像（Tiki 27.5 内容大小约 586 MB）：

bash
docker images

---

四、创建目录并编写 Compose

bash
mkdir -p /www/wwwroot/tikiwiki
cd /www/wwwroot/tikiwiki

4.1 创建 docker-compose.yml

bash
vim docker-compose.yml

完整内容（与 Ubuntu 24.04 实测一致，请将密码改为强密码）：

yaml
name: tikiwiki

services:
  tiki:
    image: docker.xuanyuan.run/tikiwiki/tikiwiki:27.5
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "8080:80"
    environment:
      TIKI_DB_HOST: db
      TIKI_DB_USER: tiki
      TIKI_DB_PASS: YourStrongPass123
      TIKI_DB_NAME: tikiwiki
    volumes:
      - tiki_files:/var/www/html/files/
      - tiki_storage:/var/www/html/storage/
      - tiki_temp:/var/www/html/temp/
      - tiki_sessions:/var/www/sessions/

  db:
    image: docker.xuanyuan.run/library/mariadb:latest
    restart: unless-stopped
    environment:
      MYSQL_USER: tiki
      MYSQL_PASSWORD: YourStrongPass123
      MYSQL_DATABASE: tikiwiki
      MYSQL_ROOT_PASSWORD: YourRootPass123
      TERM: dumb
    volumes:
      - db_data:/var/lib/mysql
    healthcheck:
      test: ["CMD-SHELL", "mariadb-admin ping -h 127.0.0.1 -u\"$$MYSQL_USER\" -p\"$$MYSQL_PASSWORD\" || exit 1"]
      start_period: 30s
      interval: 5s
      timeout: 5s
      retries: 15

volumes:
  tiki_files:
  tiki_storage:
  tiki_temp:
  tiki_sessions:
  db_data:

各参数说明：

三角色密码对照（安装向导易混，务必分清）：

---

五、启动与日志

bash
docker compose up -d
docker compose ps
docker compose logs -f tiki
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8080

本文实测 docker compose up -d 输出摘要：

text
✔ Container tikiwiki-db-1        Healthy    17.1s
✔ Container tikiwiki-tiki-1      Started    17.3s

docker compose ps 期望状态：

text
tikiwiki-db-1     ... Up ... (healthy)   3306/tcp
tikiwiki-tiki-1   ... Up ...             0.0.0.0:8080->80/tcp

Tiki 日志中出现 Apache 启动成功即可（ServerName 警告可忽略）：

text
Apache/2.4.57 (Debian) PHP/8.1.27 configured -- resuming normal operations

curl 返回 302 表示服务正常（自动跳转安装向导）。若返回 000，见 FAQ Q2。

---

六、Web 安装向导（9 步跟做）

在浏览器打开（将 IP 换成你的服务器地址）：

http://192.168.1.18:8080

会自动跳转到 tiki-install.php。左侧为 9 步进度条，按顺序跟做即可。

6.1 第 0 步：Security Precaution（安全校验）

首次进入安装页，会先出现 Security Precaution 页，要求输入数据库用户名和密码以验证你是站点管理员。

图 1：Security Precaution 页——此处只填数据库凭据，不是站点管理员账号

填好后点击 Validate and Continue。

踩坑提示：若提示用户名密码不对，在 compose 目录执行 docker compose exec db mariadb -u tiki -p'YourStrongPass123' -e "SHOW DATABASES;" 验证；若 Access denied，检查 compose 中两处密码是否一致，或 docker compose down -v 清卷重装（会清空数据库）。

6.2 第 1 步：Welcome（欢迎）

进入正式安装向导 Tiki Installer 27.5，第一步为 Welcome。

图 2：Welcome 页，可选择安装语言

在 Select your language 下拉框中选择 Simplified Chinese（简体中文, cn）：

图 3：语言选择为简体中文

点击 Continue（继续）。

6.3 第 2 步：License（许可协议）

阅读 LGPL 许可协议，点击 Continue 接受。

图 4：License 页，Tiki 基于 LGPL 许可发布

6.4 第 3 步：Review the System Requirements（系统要求）

Tiki 自动检测 PHP 内存等环境。本文实测 Memory 检测通过（PHP memory_limit 128 MB）。

图 5：系统要求检测通过；Mail 测试可选，不影响安装

点击 Continue 进入下一步。

6.5 第 4 步：Set the Database Connection（数据库连接）

因 Compose 中已配置 TIKI_DB_* 环境变量，Tiki 会自动写入 db/local.php，此步通常显示 Success：

图 6：检测到已有数据库连接，库名 tikiwiki

点击蓝色 Use Existing Connection（使用现有连接） 即可。若需手动修改，点橙色 Modify database connection，主机填 db，用户 tiki，库名 tikiwiki。

6.6 第 5 步：Install（安装数据库）

选择数据库引擎 InnoDB（默认），点击黄色 安装 按钮。

图 7：确认 InnoDB 后点击「安装」

安装过程会创建数据表，进度条从 0% 逐步增加（约 945 条 SQL，需等待 1～3 分钟）：

图 8：数据库表创建进行中，请耐心等待

6.7 第 6 步：Review the Installation（安装回顾）

出现绿色 Installation complete 表示数据库安装成功。安装程序提示：首次安装的管理员账号为 admin，临时密码为 admin。

图 9：安装完成，临时管理员 admin / admin（首次登录须改密）

点击 Continue。

6.8 第 7 步：Configure the General Settings（一般设置）

配置站点基本信息。Server domain name 不确定时留空（填错可能导致无法访问）。浏览器标题 可改为 My Tiki 或你的站点名。

图 10：一般设置——域名不确定时留空

填写后点击 Continue。

6.9 第 8 步：Last Notes（最后说明）

阅读安全更新订阅、向导使用等提示，点击 Continue。

图 11：Last Notes，建议订阅安全更新通知

6.10 第 9 步：Enter Your Tiki（进入 Tiki）

显示 Ready to run，安装完成。点击蓝色 Enter Tiki and Lock Installer（Recommended） 进入站点并锁定安装程序（推荐；橙色按钮不锁定安装程序，有安全风险）。

图 12：进入 Tiki 并锁定安装程序（推荐）

---

七、首次登录与改密

点击「Enter Tiki and Lock Installer」后，系统要求为 admin 设置新密码（安装时的临时密码 admin 不能长期使用）。

图 13：首次登录强制改密——填写新密码、重复密码与邮箱后点 Apply

改密成功后进入 Tiki Setup 引导页，显示 Congratulations! You now have a working instance of Tiki 27.5。

图 14：Tiki Setup 引导页，可立即使用或运行配置向导

安全提示：安装程序创建的临时账号为 admin / admin，进入站点后必须在改密页（图 13）改为强密码。公网暴露前务必完成改密，并配置 HTTPS 反向代理。

---

八、功能实测：应用公司内网 Profile

Tiki 提供 Configuration Profiles Wizard，可一键应用预设场景（协作社区、公司内网等），快速启用 Wiki、论坛、日历、Tracker 等模块。

8.1 选择 Featured Site Configurations

在 Tiki Setup 页点击 Start the Wizardry，或从 Featured Site Configurations 选择模板。本文实测选择 Company Intranet（公司内网）：

图 15：Featured Site Configurations，选择公司内网等预设场景

8.2 管理后台 Profiles 页

也可从管理后台进入 Profiles 页面浏览并应用配置模板：

图 16：管理后台 Profiles 页；顶部可能提示发件邮箱未设置、版本升级建议

8.3 应用 Company Intranet Profile

选择 Company_Intranet_21 Profile，点击 Apply Now，在确认框点 OK：

图 17：确认应用 Company_Intranet_21 Profile

8.4 内网首页

Profile 应用成功后，首页标题变为 Our Intranet，顶部出现成功提示，左侧 System Menu 已启用 Wiki、博客、论坛、Tracker、文件库等模块：

图 18：公司内网 Profile 应用成功，Wiki / 论坛 / Tracker 等模块已就绪

---

九、生产环境建议

9.1 固定镜像 digest

生产环境建议用 digest 固定构建，避免标签漂移：

bash
docker pull docker.xuanyuan.run/tikiwiki/tikiwiki:27.5
docker inspect docker.xuanyuan.run/tikiwiki/tikiwiki:27.5 --format='{{index .RepoDigests 0}}'

本文拉取 digest 示例：sha256:096cc953fb1cb3c5de4cb3523470ba0e128ba78b39825c45d722c6d82a0ca165

9.2 Nginx 反向代理（示例）

nginx
server {
    listen 80;
    server_name wiki.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

9.3 备份

bash
cd /www/wwwroot/tikiwiki
docker compose exec db mariadb-dump -u tiki -p'YourStrongPass123' tikiwiki > tikiwiki-backup.sql

数据库在 db_data 卷，上传文件在 tiki_files 等卷，升级前建议一并备份。

---

十、常见问题 FAQ

Q1：docker compose up -d 报 unknown shorthand flag: 'd' in -d？

说明 Compose V2 未安装。Ubuntu 官方 docker.io 包请安装 docker-compose-v2：

bash
sudo apt update
sudo apt install -y docker-compose-v2
docker compose version

Q2：本机 curl 127.0.0.1:8080 返回 000，浏览器连接拒绝？

8080 无进程监听。执行 docker compose ps -a：若 tiki 为 Created 或 Exited，执行 docker compose up -d tiki 并查看 docker compose logs tiki。常见原因：db 未 healthy 导致 Tiki 未启动。

Q3：Security Precaution 页数据库用户名密码不对？

填 tiki + MYSQL_PASSWORD（应用用户密码），不要填 tikiwiki（库名）或 YourRootPass123（root 密码）。验证：

bash
docker compose exec db mariadb -u tiki -p'YourStrongPass123' -e "SHOW DATABASES;"

Q4：安装向导连不上数据库？

检查 TIKI_DB_HOST=db、应用用户密码与 MariaDB 环境变量一致、db 容器为 (healthy)。

Q5：8080 被占用怎么办？

将 compose 中 "8080:80" 改为 "8090:80"，浏览器访问 http://YOUR_SERVER_IP:8090。

Q6：管理员账号密码是什么？

Web 安装完成后，安装程序提示临时账号 admin / admin。进入站点后必须在改密页（图 13）设置新密码；这不是长期可用的默认密码。

Q7：是否需要设 TIKI_DB_VERSION？

使用固定标签 27.5 时一般不必手动设；仅 latest 或 CLI 装库场景才需关注。

Q8：能否用 MySQL 替代 MariaDB？

官方 Docker 示例为 MariaDB，生产建议跟随官方；MySQL 8 兼容性未在本文实测范围。

Q9：日志里 Could not reliably determine the server's fully qualified domain name？

Apache 的 ServerName 提示，不影响使用，可忽略。

Q10：安装完成后还提示版本不再支持？

Tiki 27.5 安装后可能提示建议升级到 27.6 或更高版本，属正常提醒；生产环境可评估升级计划，本文以 27.5 标签实测为准。

---

总结

本文完成了 Tiki Wiki 27.5 双容器 Compose 私有化部署：

• 使用轩辕镜像加速拉取 tikiwiki/tikiwiki:27.5 与 library/mariadb:latest
• Docker Compose 双容器，工作目录 /www/wwwroot/tikiwiki，8080 端口访问
• MariaDB healthcheck + 命名卷持久化
• Web 安装向导 9 步跟做，含 Security Precaution 数据库凭据踩坑
• 临时管理员 admin / admin，首次登录强制改密
• 应用 Company Intranet Profile，Wiki / 论坛 / Tracker 等模块就绪（18 张配图）

延伸阅读：

• Tiki Wiki 轩辕镜像页
• Docker Hub tikiwiki/tikiwiki
• Tiki 项目官网
• Tiki 源码 GitLab
• 轩辕镜像使用手册