跳到正文
本頁目錄

在 Docker 中運行服務器

學完這篇教程,你會有一個運行在 Docker 容器裡、裝有 LeviLamina 的基岩版專用服務器,它的世界保存在 Docker 卷裡;你還會知道怎樣進入它的控制台、添加模組、安全地停止它。容器第一次啟動時會自己裝好一切:宿主機上既不用裝 lip,也不用裝 Wine。

鏡像有兩種,都來自 LiteLDev/docker-levilamina-server:

鏡像 運行在 方式
ghcr.io/liteldev/levilamina-server:latest-wine Linux 容器:x64 的 Linux 宿主機,或 Docker Desktop 通過 Wine 運行 Windows 服務器
ghcr.io/liteldev/levilamina-server:latest-windows Windows 容器:Windows Server,或切換到 Windows 容器的 Docker Desktop 直接運行 Windows 服務器

本教程使用 Wine 鏡像。Windows 鏡像見第 2 步末尾的提示。

你需要準備

  • Docker:Linux 上的 Docker Engine,或 Windows 和 macOS 上的 Docker Desktop。docker version 應當能同時列出客戶端和服務端的版本。
  • 一臺 x64 處理器的宿主機。
  • 網絡連接。容器從 minecraft.net 下載遊戲,從 GitHub 下載 LeviLamina。

1. 啟動容器

  1. 運行:

    shell
    docker run -d -it --name levilamina -e EULA=TRUE -p 19132:19132/udp -p 19132:19132/tcp -v levilamina-server-data:/data ghcr.io/liteldev/levilamina-server:latest-wine

    各部分的作用:

    • -d -it:在後臺運行,並保留一個之後可以接入的控制台。
    • --name levilamina:後面的命令用這個名字指代容器。
    • -e EULA=TRUE:表示你接受《Minecraft 最終用戶許可協議》。沒有它,容器會立即停止。
    • -p 19132:19132/udp -p 19132:19132/tcp:服務器的端口,兩種協議都要映射。
    • -v levilamina-server-data:/data:服務器、世界和設置都放在卷 levilamina-server-data 裡,刪除容器後它們依然保留。
  2. 查看容器在做什麼:

    shell
    docker logs -f levilamina

    第一次啟動時,容器會準備 Wine,用 lip 安裝 LeviLamina 和遊戲,然後啟動服務器,需要幾分鐘。最後你應該看到 Server started.。按 Ctrl+C 停止查看日誌,服務器會繼續運行。

從 GitHub 下載很慢

在 docker run 命令里加上 -e GITHUB_MIRROR_URL=<GitHub 镜像地址>,例如 -e GITHUB_MIRROR_URL=https://v4.gh-proxy.org/https://github.com/。

2. 使用控制台

  1. 接入服務器:

    shell
    docker attach levilamina
  2. 輸入一條服務器命令(不用加開頭的 /),按 Enter:

    text
    list

    你應該看到 There are 0/10 players online:。

  3. 脫離而不停止服務器:先按 Ctrl+P,再按 Ctrl+Q。

Windows 鏡像

在 Windows 容器宿主機上,使用 ghcr.io/liteldev/levilamina-server:latest-windows,並把卷掛載到 C:\data:-v levilamina-server-data:C:\data。本教程的其他內容都一樣。

3. 添加模組

容器第一次啟動、安裝服務器時,會安裝變量 PACKAGES 裡列出的包,包之間用空格分隔。LeviMC 模組目錄裡的任何模組都可以,名字就是模組頁面上 lip install 後面的部分。

要新開一個帶模組的服務器,把這個變量加進第 1 步的 docker run 命令:

shell
-e PACKAGES="github.com/LiteLDev/LeviOptimize github.com/LiteLDev/LegacyScriptEngine#lua"
給已經裝好的服務器添加模組

PACKAGES 只在第一次啟動時讀取。之後請在運行中的容器裡執行 lip:

shell
docker exec -it levilamina lip install github.com/LiteLDev/LeviOptimize

服務器下次啟動時才會加載這個模組:按第 4 步停止並重新啟動它。之後 docker logs levilamina 應當顯示 [LeviLamina] 正在加載這個模組。

4. 停止和啟動服務器

  1. 接入(docker attach levilamina)後輸入 stop。服務器保存世界後退出,容器也隨之停止。你應該在輸出裡看到 Quit correctly。

  2. 以後再啟動它:

    shell
    docker start levilamina

    第二次啟動很快:服務器已經裝在卷裡了。

docker stop 也能用,但它只給服務器 10 秒,之後就會強行結束。輸入 stop 才是安全的做法。

使用 Docker Compose

也可以不用 docker run:把 wine/compose.yaml(或 windows/compose.yaml)下載到一個空文件夾,在那裡運行 docker compose up -d。它設置了同樣的 EULA、端口和卷。PACKAGES 等變量寫在 environment: 下面。docker compose logs -f 查看日誌,docker compose attach levilamina-server 打開控制台。

容器的設置

變量 默認值 含義
EULA 必須為 TRUE。
VERSION LATEST 要安裝的 LeviLamina 版本,例如 26.60.7。遊戲版本由它決定。
PACKAGES 第一次啟動時安裝的包,用空格分隔。
GITHUB_MIRROR_URL 下載用的 GitHub 鏡像。
TZ UTC 時區,影響日誌裡的時間。
LANG、LC_ALL en_US.UTF-8 容器裡的區域設置。
WINEDEBUG -all Wine 的調試輸出(僅 Wine 鏡像)。

你現在有了什麼

  • 一個名為 levilamina 的容器,在 19132 端口上運行 LeviLamina 服務器。
  • 一個卷 levilamina-server-data,裡面有服務器、世界和設置,容器刪掉後它依然在。

下一步