在 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. 啟動容器
-
運行:
shelldocker 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裡,刪除容器後它們依然保留。
-
查看容器在做什麼:
shelldocker 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. 使用控制台
-
接入服務器:
shelldocker attach levilamina -
輸入一條服務器命令(不用加開頭的
/),按Enter:textlist你應該看到
There are 0/10 players online:。 -
脫離而不停止服務器:先按
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 命令:
-e PACKAGES="github.com/LiteLDev/LeviOptimize github.com/LiteLDev/LegacyScriptEngine#lua"給已經裝好的服務器添加模組
PACKAGES 只在第一次啟動時讀取。之後請在運行中的容器裡執行 lip:
docker exec -it levilamina lip install github.com/LiteLDev/LeviOptimize服務器下次啟動時才會加載這個模組:按第 4 步停止並重新啟動它。之後 docker logs levilamina 應當顯示 [LeviLamina] 正在加載這個模組。
4. 停止和啟動服務器
-
接入(
docker attach levilamina)後輸入stop。服務器保存世界後退出,容器也隨之停止。你應該在輸出裡看到Quit correctly。 -
以後再啟動它:
shelldocker 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,裡面有服務器、世界和設置,容器刪掉後它依然在。
下一步
- 挑選模組:給服務器安裝模組講了包名和變體。
- 讓網絡外的玩家連進來:讓朋友連上你的服務器。
- 不用 Docker 開服:開你的第一個服務器或用命令行開服。
PACKAGES接受的包名、版本和引用:管理包。- 鏡像、它們的 Dockerfile 和更新日誌:LiteLDev/docker-levilamina-server。
- 出了問題:LeviLamina 問題排除。