安装

下面的内容会具体地讲述如何安装并运行 Aphanite。

TIP

不需要服务器即可部署 Aphanite。相比本地 PC，服务器的优势是 7×24 小时开机，所以如果你并不已有正在运行的 VPS（如自己电脑开服或者面板服限制只能跑 Minecraft 服务器），无需单独为 Aphanite 购买服务器。如果你决定使用本地电脑部署，需要使用内网穿透服务。详见部署§内网穿透。

选择安装方式

Aphanite 自身是被设计为容易部署的。不过，我们也提供可以一键运行的 Docker 镜像。

• 如果你使用 Windows，且不想安装 Docker Desktop 或 Podman Desktop，那么请直接使用二进制文件。
• 如果你使用 Windows，且电脑上已经有 Docker Desktop 或 Podman Desktop，可以试一试Docker。
• 如果你使用 Linux，但十分追求一行命令的安装体验，或出于沙箱需求想要容器化，那么请使用Docker。
• 否则，我们通常会推荐直接运行二进制文件。
• 如果你对系统服务的运维已经比较熟悉了，想必你有自己的看法，那么可以直接跳到你想要的安装方法的小节里。

注意，Aphanite 默认情况下使用 Turso 数据库（Rust 版 SQLite），并且被设计为易于直接部署，使用 Docker 镜像通常来说并不会方便多少。除非你打算使用 PostgreSQL，那么可以组一个 Docker Compose，或者使用 Kubernetes 搭建你自己的 Aphanite 集群。不过这些不在本 Wiki 的讨论范围内。

直接运行二进制文件

我们提供预编译的 Windows x64 和 Linux x64 二进制文件，以供下载。

如果你的操作系统或电脑架构不在上面两种之中，恐怕你只能考虑从源码编译了。

• 在 GitHub Releases 下载
• 在 Cloudflare R2 下载（coming soon）

下载之后，直接双击 .exe 文件（Windows）或者 chmod +x 之后就可以运行。

Linux: 选择哪个文件？

TIP

Windows 用户请直接跳到下一小节。

对于 Linux 平台，我们提供两个文件。一个使用 glibc 并动态链接：它需要你系统的 glibc 版本大于或等于 2.34，且有运行所需的动态库，否则程序无法启动。另一个使用 musl libc 并静态链接，只要内核版本不太老旧就能在任意 Linux x64 系统上运行。

通常来说，如果系统 glibc 版本足够，我们推荐选择 glibc 版本，否则再考虑 musl 版本。

你可以运行以下的命令来查看你系统的 glibc 版本：

ldd --version
# 或者
/lib64/libc.so.6 # 仅 Red Hat 系（如 RHEL/Rocky/..., CentOS, Fedora）
/lib/x86_64-linux-gnu/libc.so.6 # 仅 Debian 系（如 Debian, Ubuntu）

如果你的系统是 Alpine 等轻量发行版，那么你的系统可能并没有使用 glibc libc。但不用担心，musl 版本是在所有 x64 Linux 发行版上通用的！

初始化配置文件

下载好之后，请将 Aphanite 可执行文件复制到一个当前用户有读写权限的空目录中，然后运行：

Linux 或 macOS

./aphanite init

Windows

& "./aphanite.exe" init

恭喜你，现在你的 Aphanite 已经可以启动了！

接下来呢？

看看该如何运行 Aphanite 吧。

从源码编译

Aphanite 本体是用 Rust 编写的，并且其中有前端（网页）部分，所以在开始之前，你需要安装：

• C/C++ 编译工具链。（由你使用的操作系统而定——比如说，如果你使用 macOS，需要安装 Xcode 命令行工具。）
• Rust 工具链。
• Deno。

安装好之后，运行下面的命令来克隆 Aphanite：（你也可以直接下载 Release 中的“Source code (zip)”并解压。）

git clone https://github.com/feniota/aphanite.git --depth=1

然后，打开终端，运行下面的指令：

cd aphanite
deno install
deno task build

稍等片刻。编译完成后，aphanite 二进制文件会出现在 源代码目录/target/release 下。

接下来，请看初始化配置文件。

使用 Docker 镜像

我们提供的官方 Docker 镜像位于 quay.io/feniota/aphanite。

官方镜像的基镜像是 quay.io/fedora/fedora-minimal:45，总下载大小在 70MB 左右，下载后实际占用的空间在 180MB 左右。然而，Fedora 的更新策略十分激进，所以如果你的内核版本过旧，可能会导致容器无法运行。如果遇到问题，请尝试直接使用二进制文件（记得选择 musl libc 版本）。

你可以运行以下命令拉取镜像：

podman pull quay.io/feniota/aphanite:latest
# 或者
docker pull quay.io/feniota/aphanite:latest

quay.io 有可能在国内难以访问，如果遇到下载问题，可以使用由南京大学提供的镜像源，即把 quay.io 换成 quay.nju.edu.cn。

Aphanite 在每次发布新版后，都会自动针对对应版本构建新的 Docker 镜像。每个版本的镜像都会打上对应的版本号标签，例如 quay.io/feniota/aphanite:v0.1.0。

要使用 Docker 或其他容器平台部署 Aphanite，你应该先创建一个目录来存储配置文件和数据库，下面假设这个目录是 ~/.aphanite。然后运行以下命令来启动容器：

mkdir -p ~/.aphanite
podman run -d \ # 或 docker
  --name aphanite \
  --restart unless-stopped \
  -p 3000:3000 \ # 如果你不想使用默认端口，请修改这里的前一个 3000
  -v "~/.aphanite:/app:Z" \
  quay.io/feniota/aphanite:latest

下一步，在将服务暴露到公网之前，请在 ~/.aphanite/config.toml 完成你的配置。具体请参考配置章节。

自行构建 Docker 镜像

如果你不想使用我们预构建的官方镜像，你也可以自行编译。下载源码后，运行：

podman build -t aphanite:latest .
# 或者
docker build -t aphanite:latest .

你也可以自行修改 Dockerfile 来满足你的需求。不过请注意，如果你使用默认参数编译 Aphanite，很有可能会生成一个 glibc 动态链接的二进制文件，这在某些类型的容器基础镜像上（尤其是 Alpine 或 scratch）可能无法运行。