在 Debian 12 中使用 Podman 和 Docker Compose 安装 Wiki.js
Wiki.js 是一个现代且强大的开源维基软件。它轻量、快速,并且支持 Markdown。在本指南中,我们将向您展示如何在 Debian Linux 12 上使用 Podman 和 Docker Compose 安装 Wiki.js。
先决条件
- Debian Linux 12 已安装并正在运行。
- Podman 桌面版 已以无根模式安装。
- 已安装 Podman Compose 或 Docker Compose。
第1步:启用Podman套接字
在运行 Docker Compose 命令之前,启用 Podman 套接字以兼容:
启动 Podman 套接字服务:
systemctl --user enable --now podman.socket验证套接字是否在运行:
systemctl --user status podman.socket导出 Docker Host 环境变量:
echo 'export DOCKER_HOST=unix:///run/user/$UID/podman/podman.sock' >> ~/.bashrcsource ~/.bashrc第2步:创建 Wiki.js 组合文件
创建一个名为 docker-compose.yml 的文件,并将以下内容复制到其中:
version: "3"
services:
db:
image: postgres:15-alpine
environment:
POSTGRES_DB: wiki
POSTGRES_PASSWORD: wikijsrocks
POSTGRES_USER: wikijs
logging:
driver: "none" # Logs disabled
restart: unless-stopped
volumes:
- db-data:/var/lib/postgresql/data
wiki:
image: ghcr.io/requarks/wiki:2
depends_on:
- db
environment:
DB_TYPE: postgres
DB_HOST: db
DB_PORT: 5432
DB_USER: wikijs
DB_PASS: wikijsrocks
DB_NAME: wiki
restart: unless-stopped
ports:
- "8081:3000"
volumes:
db-data:保存并关闭文件。
第3步:使用 Podman 启动 Wiki.js
- 打开终端。
- 导航到你保存 docker-compose.yml 文件的目录。
- 运行以下命令:
podman-compose up -d此命令将以分离模式启动 Wiki.js 和 PostgreSQL 容器。
第4步:在浏览器中访问 Wiki.js
打开你的网页浏览器,并从地址栏访问 http://localhost:8081。现在,Wiki.js 的实际安装将开始。
输入 Wiki.js 管理员用户的管理电子邮件 ID、登录密码、您的 Wiki 网址,然后点击 安装。电子邮件 ID 将作为用户名。
这将花费一些时间来设置 Wiki.js。安装完成后,您将被重定向到 Wiki.js 登录页面。输入您的电子邮件 ID 和您在上一步提供的密码。
就是这样。你现在可以开始设计你的主页,或者进入管理页面,从那里你可以创建所有必要的页面。
这就是 Wiki.js 管理部分的样子。
要开始使用 Wiki.js,请访问 Wiki.js 文档。
步骤5:管理容器
检查正在运行的容器:
podman ps停止容器:
podman-compose down查看日志:
podman logs <container-id>结论
您已成功在 Debian Linux 12 上使用 Podman 和 Docker Compose 安装了 Wiki.js。此设置使用 PostgreSQL 作为数据库,并以无根模式运行,使其既安全又高效。


