在 Docker 中運行 LeviLamina
用 LeviLamina 官方 docker 鏡像部署後,怎麼查看日誌、進入服務器控制台輸入命令(能用 docker exec 嗎)、以及找到服務器數據?attach 後沒有任何輸出正常嗎?
用 docker ps(或 podman ps)查看容器名/ID;docker logs -f <容器名> 查看日誌;docker attach <容器名> 接入服務器控制台輸入命令(不加開頭的 /),按 Ctrl+P 再按 Ctrl+Q 脫離而不停止服務器。容器需以 -d -it 啟動(compose 中為 stdin_open: true、tty: true)。attach 後不會回顯之前的日誌,看起來沒反應是正常的,輸入一條命令(如 list)即可看到輸出。docker exec 進入的是容器裡的新 shell,看不到也無法輸入 BDS 控制台(docker exec 可用來在容器裡執行 lip 等命令)。服務器數據在 volume 中(容器內 /data),可用 docker volume inspect levilamina-server-data 查看宿主機上的存儲位置;不要在宿主機上再直接啟動 volume 裡的 bedrock_server_mod.exe。另外 LeviLamina 註冊的命令默認不需要開啟作弊即可使用。
適用版本:docker-levilamina-server 0.9.x(wine 與 windows 鏡像)
用 LeviLamina docker 鏡像拉到/裝上的是很舊的版本(鏡像本身很舊,或 VERSION=LATEST 仍裝舊版 LL),怎麼辦?
- 如果拉下來的鏡像本身很舊(例如很早期的版本),多半是用了國內 docker 鏡像加速站,它緩存的是舊鏡像。請直接從官方源
ghcr.io/liteldev/levilamina-server:latest-wine(或latest-windows)拉取,或換一個同步正常的鏡像站,必要時先docker pull更新鏡像。 - 環境變量
VERSION(默認LATEST,可指定如26.60.7,不帶v前綴)只在第一次啟動、卷裡還沒有bedrock_server_mod.exe時生效;卷裡已經裝過服務器時,改VERSION或換新鏡像都不會重新安裝 LL。要升級已有服務器裡的 LeviLamina,在容器裡用lip setup同時指定遊戲版本和 LL 版本,例如docker exec -it <容器名> lip setup --game <该 LL 版本支持的游戏版本> --loader levilamina@<LL 版本> --accept-eula(可先加--dry-run查看影響),然後重啟容器(docker stop -t 60再docker start);注意lip update不能更新遊戲和 LeviLamina,會拒絕並提示改用lip setup。也可以新建一個卷重新部署。 - LL 本體在
mods/LeviLamina,遷移舊服務器時不要把舊的 LeviLamina 目錄覆蓋回去,只拷貝worlds、allowlist.json、server.properties等數據和其他模組。
教程:https://levimc.org/zh-Hant/tutorials/server/docker/
適用版本:docker-levilamina-server 0.9.x(lip v0.41+)
LeviLamina 服務器有 docker 部署方式嗎?能掛載數據嗎?鏡像裡沒有 Python 運行環境怎麼辦?
有官方鏡像 ghcr.io/liteldev/levilamina-server:latest-wine(Linux 容器)和 :latest-windows(Windows 容器),服務器、世界和設置都在 /data(Windows 為 C:\data),可用命名卷或 bind mount 掛載。官方 LeviLamina 鏡像不含 Python。如果是為了跑 LeviStone/Endstone Python 插件,直接用官方 ghcr.io/liteldev/levistone-server 鏡像(已內置 Python 和 LeviStone);其他需求可基於官方鏡像 docker build 二次打包:Windows 鏡像可在 servercore 裡自行安裝 Python;Linux(Wine)鏡像中 BDS 跑在 lip 安裝的 Wine 裡,Python 也要裝進那個 Wine 前綴(/data/.lip/wine),而不是 apt install python3,可參考 docker-levistone-server 的實現。
適用版本:docker-levilamina-server 0.9.x;docker-levistone-server 0.3.x
在 Windows 容器中運行 LeviLamina/BDS,能用 nanoserver 作基礎鏡像嗎?nanoserver 裝不上 VC 運行庫怎麼辦?
nanoserver 缺少大量組件,裝不上 VC 運行庫,也跑不起 BDS/LeviLamina;請使用 servercore 基礎鏡像(官方 Windows 鏡像用的就是 mcr.microsoft.com/windows/servercore:ltsc2022)。在 servercore 中可靜默安裝 VC 運行庫:vc_redist.x64.exe /install /quiet /norestart。想減小體積只能在 servercore 上逐項裁剪。
適用版本:Windows 容器,當前所有版本。未能從源碼或文檔中直接證實,僅供參考。
用 docker 部署 LeviLamina,服務端文件和配置文件(server.properties 等)在哪裡?
都在容器的數據目錄 /data(Windows 鏡像為 C:\data),bedrock_server_mod.exe、server.properties、worlds、mods 等都在這裡,對應掛載的卷(默認 levilamina-server-data)。在宿主機上用 docker volume inspect levilamina-server-data 查看卷的實際路徑;也可以改用 bind mount(-v /宿主机目录:/data)直接訪問。
適用版本:docker-levilamina-server 當前所有版本
Linux 面板服(如翼龍/Pterodactyl 面板)如何安裝 LeviLamina?
需要面板(或服務商)支持運行 Windows 版 BDS + Wine 的環境,可參考官方 docker 鏡像的實現:https://github.com/LiteLDev/docker-levilamina-server(Linux 鏡像裡由原生 lip 執行 lip install --accept-eula github.com/LiteLDev/LeviLamina 安裝,再用 lip run 啟動,lip 會自帶 Wine)。
適用版本:當前所有版本,x64 Linux
在 Linux 上用 LeviLamina docker 鏡像運行服務器,執行 pip install levistone --target ... 報 No matching distribution found for levistone,如何在 docker 裡用 LeviStone?
官方 LeviLamina 鏡像(levilamina-server)沒有 Python 環境,在 Linux 宿主機/容器裡直接用 Linux 的 pip 也裝不了(LeviStone 需要裝在運行服務器的 Wine 裡的 Windows 版 Python 中)。請直接改用官方的 LeviStone 鏡像:
docker run -d -it --name levistone -e EULA=TRUE -p 19132:19132/udp -p 19132:19132/tcp -v levistone-server-data:/data ghcr.io/liteldev/levistone-server:latest-wine它會把 Python 裝進 Wine 前綴,並用 pip 把 LeviStone 裝到 mods/EndstoneRuntime;Endstone 插件放在卷中的 plugins/ 目錄。可用 LEVISTONE_VERSION 指定版本(須與 LeviLamina 版本匹配),PYPI_MIRROR_URL 指定 PyPI 鏡像。
適用版本:docker-levistone-server 0.3.x 及以上
面板服或 Wine 環境下無法安裝 LeviStone,有其它在 Linux 上運行 LeviStone 的辦法嗎?
使用官方 LeviStone docker 鏡像:https://github.com/LiteLDev/docker-levistone-server(ghcr.io/liteldev/levistone-server:latest-wine),首次啟動會自動安裝 Wine、VC 運行庫、遊戲、LeviLamina、Python 和 LeviStone。國內可用 GITHUB_MIRROR_URL、PYPI_MIRROR_URL 和 ghcr.nju.edu.cn 加速。
適用版本:docker-levistone-server 當前版本
在 Linux(如用 MCSManager)上運行 LeviLamina 服務端,啟動後模組(插件)沒有加載,怎麼辦?
LeviLamina 只有 Windows 版,在 Linux 上必須用 Wine 運行 Windows 版服務端(bedrock_server_mod.exe),直接跑 Linux 版 BDS 是不會加載 LeviLamina 和模組的。最簡單的做法是用 Docker 運行官方鏡像 ghcr.io/liteldev/levilamina-server:latest-wine(倉庫 https://github.com/LiteLDev/docker-levilamina-server),例如:
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容器首次啟動時 lip 會自動裝好 Wine、VC++ 運行庫、遊戲和 LeviLamina,宿主機不需要裝 Wine。也可以不用 Docker:x64 Linux 上直接用 Linux 版 lip 開服,lip 會用自帶的 Wine 運行 Windows 服務端。國內從 GitHub 下載慢/超時,可加 -e GITHUB_MIRROR_URL=<GitHub 镜像地址>,拉取 ghcr.io 鏡像本身也可能需要代理或鏡像源。
適用版本:當前所有版本(docker-levilamina-server 0.9.x / lip v0.41+)
在官方 LeviLamina docker 容器裡如何安裝 LSE 等模組?為什麼容器裡 LeviLamina 顯示的是英文?
官方鏡像自帶 lip。已裝好的服務器用 docker exec 在運行中的容器裡執行 lip,例如:
docker exec -it levilamina lip install github.com/LiteLDev/LegacyScriptEngine#quickjs(變體有 #lua、#quickjs、#nodejs、#python),裝完後重啟容器(docker stop -t 60 levilamina && docker start levilamina)模組才會加載。新開服務器時也可以用環境變量 PACKAGES 在首次啟動時一併安裝。
顯示英文是因為 LeviLamina 配置 mods/LeviLamina/config/Config.json 中 "language" 默認為 "system",跟隨容器的系統區域設置,而容器默認不是中文。使用 wine 鏡像時可以給容器傳入 -e LANG=zh_CN.UTF-8(必要時同時設 LC_ALL),或直接把 Config.json 裡的 language 改為 "zh_CN"(寫成 "zh-CN" 也可以)後重啟。
適用版本:docker-levilamina-server 0.9.x;LeviLamina 當前版本;LSE 當前版本
用 Docker 部署 LeviLamina 服務器好用嗎?Windows 容器能跑嗎?
官方提供兩種鏡像:ghcr.io/liteldev/levilamina-server:latest-wine(Linux 容器,lip 原生運行並用自裝 Wine 運行 Windows 服務端)和 ghcr.io/liteldev/levilamina-server:latest-windows(Windows 容器)。Windows 鏡像基於 mcr.microsoft.com/windows/servercore:ltsc2022,可以運行 LeviLamina;如果自己構建 Windows 鏡像,建議同樣使用 servercore 作為基礎鏡像,nanoserver 一般不適合運行完整的服務端。Windows 鏡像卷要掛載到 C:\data。是否用 Docker 取決於習慣:如果宿主機本來就是 Windows,直接開服(配合面板、開機自啟)通常更簡單;Linux 宿主機推薦用官方 wine 鏡像。注意要接入控制台用 docker attach,且容器要以 -it 運行。
適用版本:docker-levilamina-server 0.9.x
用 MCSManager 面板(Docker 鏡像方式)搭建 LeviLamina 服務器,啟動命令和容器應該怎麼配置?
鏡像填 ghcr.io/liteldev/levilamina-server:latest-wine;啟動命令留空(使用鏡像自帶的 entrypoint);容器內掛載目錄設為 /data;端口映射 19132:19132/udp(官方示例同時映射 19132:19132/tcp);需要可交互控制台(-it)。環境變量:
EULA=TRUE(必須是大寫TRUE,entrypoint 區分大小寫,寫true會直接退出)LANG=zh_CN.UTF-8(可選,中文區域設置)WINEDEBUG=-all(未設置時 lip 運行服務端會默認設為-all,可不填)- 可選:
VERSION、PACKAGES、GITHUB_MIRROR_URL、TZ
如果啟動時出現崩潰日誌相關報錯,可在 mods/LeviLamina/config/Config.json 中把 modules.crashLogger.enabled 設為 false 排查。
適用版本:docker-levilamina-server 0.9.x;LeviLamina 當前版本
用 docker 運行 ghcr.io/liteldev/levilamina-server:latest-wine 後,客戶端提示版本不匹配無法進入,需要什麼版本的 MC?
鏡像裡的遊戲(BDS)版本由所裝的 LeviLamina 版本決定(環境變量 VERSION,默認 LATEST 即最新 LeviLamina),而 LeviLamina 適配新版 MC 需要時間,所以服務端版本經常低於最新客戶端。客戶端版本需要與該 LeviLamina 版本支持的 BDS 版本一致(可在 LeviLamina 的 release 說明中查看對應遊戲版本),或等待 LeviLamina 適配新版後用新版本重新部署。也有第三方模組可以讓更高版本的客戶端進入,但不屬於 LiteLDev 官方支持範圍。
使用 LeviLamina 官方 docker 鏡像運行服務端時,控制台(如 MCSManager 面板)裡的中文顯示為亂碼,怎麼解決?
先給容器傳入區域設置環境變量 LANG=zh_CN.UTF-8(必要時同時設 LC_ALL=zh_CN.UTF-8),wine 鏡像已包含全部區域設置(locales-all),Wine 會按該區域設置轉換輸出編碼。然後檢查面板(MCSM)實例的終端/輸出編碼是否為 UTF-8。仍然亂碼時可臨時把 LeviLamina 的 language 改為英文規避,但只輸出中文的模組仍可能亂碼。
適用版本:docker-levilamina-server wine 鏡像(0.7.1 起含 locales-all)。未能從源碼或文檔中直接證實,僅供參考。
使用 ghcr.io/liteldev/levilamina-server 鏡像時,如何指定 LeviLamina 版本、使用鏡像加速、預裝模組?
通過環境變量配置:
EULA=TRUE(必須,大寫)VERSION:要安裝的 LeviLamina 版本,如26.60.7,默認LATEST(最新),遊戲版本由它決定GITHUB_MIRROR_URL:下載用的 GitHub 鏡像(即 lip 的github_proxy),如https://v4.gh-proxy.org/https://github.com/PACKAGES:首次啟動時用 lip 安裝的包,空格分隔- 另有
TZ、LANG/LC_ALL、WINEDEBUG(僅 wine 鏡像,默認-all)
例:
docker run -d -it --name levilamina -e EULA=TRUE -e VERSION=26.60.7 -e PACKAGES="github.com/LiteLDev/LeviOptimize" -p 19132:19132/udp -p 19132:19132/tcp -v levilamina-server-data:/data ghcr.io/liteldev/levilamina-server:latest-wine注意 VERSION 和 PACKAGES 只在首次安裝(卷裡還沒有 bedrock_server_mod.exe)時生效;之後加模組請用 docker exec -it levilamina lip install <包>。
適用版本:docker-levilamina-server 0.8.8 及以上(當前 0.9.1)