下载
Pick your system, download the build, and run it. Advanced installs are one click away if you need them.
Choose your platform
Tap the system you use. We show the recommended download first.
Windows 10 / 11
Download the installer, run it, and open MeshChatX from the Start menu. Use portable if you prefer no install.
仅 64 位
Linux
Most people want the AppImage. Download it, make it executable, and run it.
AppImage
无需包管理器的便携构建。请下载对应架构。
chmod +x MeshChatX-*.AppImage
./MeshChatX-*.AppImageMore install options
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.1容器
Copy the Compose file if you run Docker or Podman day to day. Pull commands are under more options.
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:More install options
使用 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
Install from PyPI with pip. That is enough for most people.
pypi.org/project/reticulum-meshchatx
pip install reticulum-meshchatxMore install options
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/v4.8.3/reticulum_meshchatx-4.8.3-py3-none-any.whlpipx install https://github.com/Quad4-Software/MeshChatX/releases/download/v4.8.3/reticulum_meshchatx-4.8.3-py3-none-any.whlpoetry add https://github.com/Quad4-Software/MeshChatX/releases/download/v4.8.3/reticulum_meshchatx-4.8.3-py3-none-any.whluv pip install https://github.com/Quad4-Software/MeshChatX/releases/download/v4.8.3/reticulum_meshchatx-4.8.3-py3-none-any.whlAndroid
Use the APK when it is available, or install via Termux for a headless node.
通用 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