遇到问题了吗?

先翻下面的常见问题, 大多能直接解决; 找不到答案就到 GitHub 提 Issue, 附上 doctor 输出或日志, 定位更快。

常见问题

01怎么安装?

Linux(Debian / Ubuntu):

curl -fsSL https://www.1b1t.cn/1b1t-apt-key.gpg | sudo tee /etc/apt/keyrings/1b1t.gpg >/dev/null

echo 'deb [signed-by=/etc/apt/keyrings/1b1t.gpg] https://www.1b1t.cn/1b1t-apt/ stable main' | sudo tee /etc/apt/sources.list.d/1b1t.list

sudo apt update && sudo apt install 1b1t-open-server

Windows: 下载中心下 MSI 安装包, 双击一键安装 (图形版 + 命令行版, 自带运行环境)。

macOS: 下载 dmg, 把 1b1t-gui.app 拖进 Applications。

02需要自己装 Java 吗?

不用。工具会自动检测 Java, 没有时自动提示; 并按 MC 版本自动选版本: ≤1.16.5 → Java 8, 1.17 → Java 16, 1.18–1.20.4 → Java 17, ≥1.20.5 → Java 21。

03服务器开起来了但别人连不上?
  • 先跑 1b1t doctor 自检 (Java/端口/jar/EULA/磁盘/权限/内存/日志 8 项)
  • 检查端口占用: 默认 25565, 换一个不冲突的端口
  • 云服务器: 在控制台安全组/防火墙放行对应端口 (TCP)
  • 局域网联机: 确认客户端和服务器同一网络
04内存怎么设置?

开服向导里有内存选项, 直接填数字即可 (如 2 自动按 2G 处理)。建议: 纯净服 2–4G, 大型整合包 6G 起; 不要超过机器物理内存的 70%。

05怎么备份存档?

软件内置一键备份, 可在设置里开启定时备份 (每隔 N 分钟自动备份)。重要存档建议同时定期手动复制到其他磁盘/网盘。

06怎么更新到最新版?
  • Linux: sudo apt update && sudo apt upgrade
  • Windows / macOS: 官网下载中心下载新版安装包, 覆盖安装即可 (数据不受影响)
07GUI 窗口拖不动 / 大小乱变?

v2.0.3 起窗口固定 980×640, 按住窗口空白区域 (非按钮/输入框) 即可拖动; Linux Wayland 会话下由系统级拖动接管, 不会再被合成器拉伸或分屏。

08支持哪些 Minecraft 版本?

全部版本 (含老版本与快照)。服务端核心自动从国内镜像下载, 失败回退官方源, 带 SHA1 校验。

09我的存档和配置存在哪? 会上传吗?

全部存在你选择的服务器目录, 纯本地运行, 不收集、不上传任何数据。软件仅在检查更新时访问官网获取版本号。

10还在用 1.x 旧版本?

v2.0.1 起不再为 1.x 系列提供支持与责任, 请尽快升级到最新版 (升级方式见上一条)。

反馈与求助

遇到 FAQ 覆盖不了的问题、想报 Bug 或提建议, 到 GitHub 提 Issue。

附上 1b1t doctor 输出或相关日志, 定位更快。

提交 Issue