本文基于 tikiwiki/tikiwiki:27.5 与 library/mariadb:latest 镜像Ubuntu 24.04 服务器实测服务器 IP192.168.1.18访问端口8080Wiki、知识库、工单、论坛、博客、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协作编辑、版本历史、权限控制Tracker内置低代码 / 无代码数据库应用构建器论坛 / 博客 / 日历团队沟通与内容发布文件库 / 知识库文档与附件集中管理CRM / 工单 / 会员轻量业务集成场景典型使用场景团队私有 Wiki 与知识库小公司内网门户 协作替代部分 Confluence Jira 论坛的多套 SaaS 组合。部署要点Tiki不能单容器跑生产须配套MariaDB官方 Docker 示例使用mariadb。本文采用Docker Compose 双容器Web 安装向导基础方案多副本 HAProxy 扩展模式不在本文范围。架构示意浏览器 ──HTTP:8080──▶ Tiki 容器 (Apache PHP 8.1) Tiki 容器 ──3306 内网──▶ MariaDB 容器 Tiki ──命名卷──▶ files / storage / sessions 等持久化二、环境要求项目建议操作系统Linux本文 Ubuntu 24.04Docker已安装 Docker 与 Docker Compose V2内存≥ 2 GB推荐 4 GBTiki MariaDB 双容器CPU双核即可磁盘≥ 5 GBTiki 镜像约 586 MB MariaDB 数据库与上传文件端口8080映射容器 80宝塔 / Nginx 占 80 时勿直接绑 80工作目录/www/wwwroot/tikiwiki独立目录勿与其他项目混用验证 Dockerdocker--versiondockercompose version若尚未安装 Docker可使用轩辕镜像一键脚本bash(wget-qO- https://xuanyuan.cloud/docker.sh)更多安装说明见 轩辕镜像使用手册。若docker compose不可用见文末FAQ Q1。镜像版本对照标签适用场景tikiwiki/tikiwiki:27.5本文主镜像Tiki 27.5 稳定版tikiwiki/tikiwiki:latest最新版生产建议固定 digestlibrary/mariadb:latest官方示例配套数据库三、拉取镜像先拉 Tiki 主镜像再拉 MariaDBdockerpull docker.xuanyuan.run/tikiwiki/tikiwiki:27.5dockerpull docker.xuanyuan.run/library/mariadb:latest成功时终端显示Status: Downloaded newer image for ...。本文实测拉取输出摘要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 MBdockerimages官方镜像轩辕镜像加速拉取说明tikiwiki/tikiwiki:27.5docker.xuanyuan.run/tikiwiki/tikiwiki:27.5本文主镜像library/mariadb:latestdocker.xuanyuan.run/library/mariadb:latest配套数据库四、创建目录并编写 Composemkdir-p/www/wwwroot/tikiwikicd/www/wwwroot/tikiwiki4.1 创建docker-compose.ymlvimdocker-compose.yml完整内容与 Ubuntu 24.04 实测一致请将密码改为强密码name:tikiwikiservices:tiki:image:docker.xuanyuan.run/tikiwiki/tikiwiki:27.5restart:unless-stoppeddepends_on:db:condition:service_healthyports:-8080:80environment:TIKI_DB_HOST:dbTIKI_DB_USER:tikiTIKI_DB_PASS:YourStrongPass123TIKI_DB_NAME:tikiwikivolumes:-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:latestrestart:unless-stoppedenvironment:MYSQL_USER:tikiMYSQL_PASSWORD:YourStrongPass123MYSQL_DATABASE:tikiwikiMYSQL_ROOT_PASSWORD:YourRootPass123TERM:dumbvolumes:-db_data:/var/lib/mysqlhealthcheck:test:[CMD-SHELL,mariadb-admin ping -h 127.0.0.1 -u\$$MYSQL_USER\ -p\$$MYSQL_PASSWORD\ || exit 1]start_period:30sinterval:5stimeout:5sretries:15volumes:tiki_files:tiki_storage:tiki_temp:tiki_sessions:db_data:各参数说明参数说明TIKI_DB_*与MYSQL_*应用用户、密码、库名必须一致8080:80宿主机 8080 → 容器 Apache 8080 空闲可改80:80depends_onhealthcheck等 MariaDB 就绪后再启动 Tiki命名卷持久化上传文件、storage、session 与数据库三角色密码对照安装向导易混务必分清角色用户名密码来源用途应用数据库用户tikiMYSQL_PASSWORD/TIKI_DB_PASS安装向导填这个数据库 rootrootMYSQL_ROOT_PASSWORD仅数据库维护不要填进安装向导Tiki 站点管理员admin安装完成后临时为admin首次登录须改密不是Security Precaution 页要填的五、启动与日志dockercompose up-ddockercomposepsdockercompose logs-ftikicurl-s-o/dev/null-w%{http_code}\nhttp://127.0.0.1:8080本文实测docker compose up -d输出摘要✔ Container tikiwiki-db-1 Healthy 17.1s ✔ Container tikiwiki-tiki-1 Started 17.3sdocker compose ps期望状态tikiwiki-db-1 ... Up ... (healthy) 3306/tcp tikiwiki-tiki-1 ... Up ... 0.0.0.0:8080-80/tcpTiki 日志中出现 Apache 启动成功即可ServerName警告可忽略Apache/2.4.57 (Debian) PHP/8.1.27 configured -- resuming normal operationscurl返回302表示服务正常自动跳转安装向导。若返回000见 FAQ Q2。六、Web 安装向导9 步跟做在浏览器打开将 IP 换成你的服务器地址http://192.168.1.18:8080会自动跳转到tiki-install.php。左侧为 9 步进度条按顺序跟做即可。6.1 第 0 步Security Precaution安全校验首次进入安装页会先出现Security Precaution页要求输入数据库用户名和密码以验证你是站点管理员。图 1Security Precaution 页——此处只填数据库凭据不是站点管理员账号字段正确填写常见误填Database usernametiki❌tikiwiki这是库名Database passwordYourStrongPass123TIKI_DB_PASS❌YourRootPass123这是 root 密码填好后点击Validate and Continue。踩坑提示若提示用户名密码不对在 compose 目录执行docker compose exec db mariadb -u tiki -pYourStrongPass123 -e SHOW DATABASES;验证若 Access denied检查 compose 中两处密码是否一致或docker compose down -v清卷重装会清空数据库。6.2 第 1 步Welcome欢迎进入正式安装向导Tiki Installer 27.5第一步为 Welcome。图 2Welcome 页可选择安装语言在Select your language下拉框中选择Simplified Chinese简体中文, cn图 3语言选择为简体中文点击Continue继续。6.3 第 2 步License许可协议阅读 LGPL 许可协议点击Continue接受。图 4License 页Tiki 基于 LGPL 许可发布6.4 第 3 步Review the System Requirements系统要求Tiki 自动检测 PHP 内存等环境。本文实测Memory检测通过PHPmemory_limit128 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需等待 13 分钟图 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。图 11Last Notes建议订阅安全更新通知6.10 第 9 步Enter Your Tiki进入 Tiki显示Ready to run安装完成。点击蓝色Enter Tiki and Lock InstallerRecommended进入站点并锁定安装程序推荐橙色按钮不锁定安装程序有安全风险。图 12进入 Tiki 并锁定安装程序推荐七、首次登录与改密点击「Enter Tiki and Lock Installer」后系统要求为admin设置新密码安装时的临时密码admin不能长期使用。图 13首次登录强制改密——填写新密码、重复密码与邮箱后点 Apply改密成功后进入Tiki Setup引导页显示Congratulations! You now have a working instance of Tiki 27.5。图 14Tiki Setup 引导页可立即使用或运行配置向导安全提示安装程序创建的临时账号为admin/admin进入站点后必须在改密页图 13改为强密码。公网暴露前务必完成改密并配置 HTTPS 反向代理。八、功能实测应用公司内网 ProfileTiki 提供Configuration Profiles Wizard可一键应用预设场景协作社区、公司内网等快速启用 Wiki、论坛、日历、Tracker 等模块。8.1 选择 Featured Site Configurations在 Tiki Setup 页点击Start the Wizardry或从Featured Site Configurations选择模板。本文实测选择Company Intranet公司内网图 15Featured Site Configurations选择公司内网等预设场景8.2 管理后台 Profiles 页也可从管理后台进入Profiles页面浏览并应用配置模板图 16管理后台 Profiles 页顶部可能提示发件邮箱未设置、版本升级建议8.3 应用 Company Intranet Profile选择Company_Intranet_21Profile点击Apply Now在确认框点OK图 17确认应用 Company_Intranet_21 Profile8.4 内网首页Profile 应用成功后首页标题变为Our Intranet顶部出现成功提示左侧System Menu已启用 Wiki、博客、论坛、Tracker、文件库等模块图 18公司内网 Profile 应用成功Wiki / 论坛 / Tracker 等模块已就绪九、生产环境建议9.1 固定镜像 digest生产环境建议用 digest 固定构建避免标签漂移dockerpull docker.xuanyuan.run/tikiwiki/tikiwiki:27.5dockerinspect docker.xuanyuan.run/tikiwiki/tikiwiki:27.5--format{{index .RepoDigests 0}}本文拉取 digest 示例sha256:096cc953fb1cb3c5de4cb3523470ba0e128ba78b39825c45d722c6d82a0ca1659.2 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 备份cd/www/wwwroot/tikiwikidockercomposeexecdb mariadb-dump-utiki -pYourStrongPass123tikiwikitikiwiki-backup.sql数据库在db_data卷上传文件在tiki_files等卷升级前建议一并备份。十、常见问题 FAQQ1docker compose up -d报unknown shorthand flag: d in -d说明Compose V2 未安装。Ubuntu 官方docker.io包请安装docker-compose-v2sudoaptupdatesudoaptinstall-ydocker-compose-v2dockercompose versionQ2本机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 未启动。Q3Security Precaution 页数据库用户名密码不对填tikiMYSQL_PASSWORD应用用户密码不要填tikiwiki库名或YourRootPass123root 密码。验证dockercomposeexecdb mariadb-utiki -pYourStrongPass123-eSHOW DATABASES;Q4安装向导连不上数据库检查TIKI_DB_HOSTdb、应用用户密码与 MariaDB 环境变量一致、db容器为(healthy)。Q58080 被占用怎么办将 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 servers fully qualified domain nameApache 的ServerName提示不影响使用可忽略。Q10安装完成后还提示版本不再支持Tiki 27.5 安装后可能提示建议升级到 27.6 或更高版本属正常提醒生产环境可评估升级计划本文以 27.5 标签实测为准。总结本文完成了 Tiki Wiki27.5 双容器 Compose 私有化部署使用轩辕镜像加速拉取 tikiwiki/tikiwiki:27.5 与 library/mariadb:latestDocker Compose 双容器工作目录/www/wwwroot/tikiwiki8080 端口访问MariaDB healthcheck 命名卷持久化Web 安装向导 9 步跟做含Security Precaution 数据库凭据踩坑临时管理员admin/admin首次登录强制改密应用Company Intranet ProfileWiki / 论坛 / Tracker 等模块就绪18 张配图延伸阅读Tiki Wiki 轩辕镜像页Docker Hub tikiwiki/tikiwikiTiki 项目官网Tiki 源码 GitLab轩辕镜像使用手册
