网站搜索

在 Debian 12 中使用 Podman 和 Docker Compose 安装 Wiki.js


Wiki.js 是一个现代且强大的开源维基软件。它轻量、快速,并且支持 Markdown。在本指南中,我们将向您展示如何在 Debian Linux 12 上使用 Podman 和 Docker Compose 安装 Wiki.js。

先决条件

  1. Debian Linux 12 已安装并正在运行。
  2. Podman 桌面版 已以无根模式安装。
  3. 已安装 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' >> ~/.bashrc
source ~/.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

  1. 打开终端。
  2. 导航到你保存 docker-compose.yml 文件的目录。
  3. 运行以下命令:
podman-compose up -d

此命令将以分离模式启动 Wiki.js 和 PostgreSQL 容器。

第4步:在浏览器中访问 Wiki.js

打开你的网页浏览器,并从地址栏访问 http://localhost:8081。现在,Wiki.js 的实际安装将开始。

输入 Wiki.js 管理员用户的管理电子邮件 ID、登录密码、您的 Wiki 网址,然后点击 安装。电子邮件 ID 将作为用户名。

安装 Wiki.js

这将花费一些时间来设置 Wiki.js。安装完成后,您将被重定向到 Wiki.js 登录页面。输入您的电子邮件 ID 和您在上一步提供的密码。

登录 Wiki.js

    就是这样。你现在可以开始设计你的主页,或者进入管理页面,从那里你可以创建所有必要的页面。

    Wiki.js 欢迎页面

    这就是 Wiki.js 管理部分的样子。

    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 作为数据库,并以无根模式运行,使其既安全又高效。