下载
选择系统，下载构建并运行。如需高级安装方式，一键即可展开。
选择平台
点选你使用的系统。我们会先显示推荐下载。
Linux
大多数人用 AppImage。下载后赋予可执行权限再运行。
AppImage
无需包管理器的便携构建。请下载对应架构。
chmod +x MeshChatX-*.AppImage
./MeshChatX-*.AppImage更多安装选项
Debian（.deb）
适用于 AMD64 与 ARM64 的 Debian 与 Ubuntu 软件包。
sudo apt install ./MeshChatX-*.deb
# fallback if apt cannot resolve dependencies:
sudo dpkg -i MeshChatX-*.deb
sudo apt -f installRPM（.rpm）
适用于 64 位 x86 系统的 RPM 软件包。
sudo dnf install ./MeshChatX-*.rpm
# or on openSUSE:
sudo zypper install ./MeshChatX-*.rpmAlpine Linux（.apk）
适用于 x86_64 Alpine Linux 的 apk-tools 软件包。不是 Android APK。
sudo apk add --allow-untrusted ./ReticulumMeshChatX-*-linux-alpine-*.apkArch
使用我们的 PKGBUILD 手动构建并安装。该方式会处理依赖并与 pacman 集成。
git clone https://github.com/Quad4-Software/MeshChatX.git
cd MeshChatX/packaging/archmakepkg -si从源码
若要在本地从源码运行 MeshChatX：
git clone https://github.com/Quad4-Software/MeshChatX.git
cd MeshChatXcorepack enable
pnpm install
pnpm run build-frontendpip install poetry
poetry install
poetry run meshchat --headless --host 127.0.0.1Flatpak
如果你的 Linux 支持 Flatpak，一键即可安装 MeshChatX。之后由 Flatpak 负责更新。
更多安装选项
终端命令
更想用终端？以下命令与上方的「安装」按钮效果相同。
flatpak install --from https://cdn.quad4.io/flatpak/meshchatx-beta.flatpakref
flatpak run com.quad4.meshchatx
flatpak updateflatpak remote-add --if-not-exists meshchatx \
https://cdn.quad4.io/flatpak/meshchatx.flatpakrepo
flatpak install meshchatx com.quad4.meshchatx//beta若曾从旧的 MeshChatX Flatpak 源安装，请先移除：flatpak remote-delete meshchatx
已下载的文件
已经下载了 .flatpak 文件？这样安装：
flatpak install --user ./ReticulumMeshChatX-*.flatpak
flatpak run com.quad4.meshchatx容器
若日常使用 Docker 或 Podman，复制 Compose 文件即可。拉取命令在更多选项中。
Compose
标准 docker-compose.yml，用于 Compose 安装。
services:
meshchatx:
image: quad4io/meshchatx:latest
# or ghcr.io/quad4-software/meshchatx:latest
ports:
- "8000:8000"
volumes:
- meshchatx-data:/root/.reticulum
volumes:
meshchatx-data:更多安装选项
使用 Docker 运行。 · AMD64 / ARM64
两个注册表为同一镜像。在 Compose 中使用 MESHCHAT_IMAGE 选择 GHCR。
docker pull quad4io/meshchatx:latestdocker pull ghcr.io/quad4-software/meshchatx:latestdocker run -d --name reticulum-meshchatx \
--restart unless-stopped \
--security-opt no-new-privileges:true \
-p 127.0.0.1:8000:8000 \
-v meshchatx-config:/config \
quad4io/meshchatx:latest使用 Podman 运行。 · AMD64 / ARM64
两个注册表为同一镜像。在 Compose 中使用 MESHCHAT_IMAGE 选择 GHCR。
podman pull quad4io/meshchatx:latestpodman pull ghcr.io/quad4-software/meshchatx:latestpodman run -d --name reticulum-meshchatx \
--restart unless-stopped \
--security-opt no-new-privileges:true \
-p 127.0.0.1:8000:8000 \
-v meshchatx-config:/config \
quad4io/meshchatx:latestDocker 镜像使用 Trivy.
Python
用 pip 从 PyPI 安装。对大多数人已足够。
pypi.org/project/reticulum-meshchatx
pip install reticulum-meshchatx更多安装选项
pipx install reticulum-meshchatxpoetry add reticulum-meshchatxuv pip install reticulum-meshchatx从该包运行 meshchatx 入口程序，无需长期安装（uv tool run）。
uvx --from reticulum-meshchatx meshchatxWheel 直链
固定该版本在 GitHub 发布中的 wheel 文件。
pip install https://github.com/Quad4-Software/MeshChatX/releases/download/beta-v4.8.6/reticulum_meshchatx-4.8.6-py3-none-any.whlpipx install https://github.com/Quad4-Software/MeshChatX/releases/download/beta-v4.8.6/reticulum_meshchatx-4.8.6-py3-none-any.whlpoetry add https://github.com/Quad4-Software/MeshChatX/releases/download/beta-v4.8.6/reticulum_meshchatx-4.8.6-py3-none-any.whluv pip install https://github.com/Quad4-Software/MeshChatX/releases/download/beta-v4.8.6/reticulum_meshchatx-4.8.6-py3-none-any.whlAndroid
应用用 Android APK，无界面节点可用 Termux。
通用 APK
Termux
通过 Termux 在 Android 上安装。先安装依赖，再从 PyPI 安装 MeshChatX。使用 meshchat --headless 无界面运行。
pkg upgrade
pkg install python
pkg install rust
pkg install binutils
pkg install build-essentialpip install reticulum-meshchatxmeshchat --headless