原生二进制安装

以单个原生二进制文件方式安装 Mobazha — 无需 Docker，也无任何运行时依赖。支持 Linux（x86_64 与 ARM64）、macOS（Apple Silicon 与 Intel）以及 Windows。

官方指南：https://mobazha.org/self-host（选择“Native Binary”标签页）及 https://mobazha.org/download

快速安装

安全提示：下方安装命令将从 get.mobazha.org 下载并执行一段 shell 脚本。运行前，您可通过 curl -sSL https://get.mobazha.org/install | less 查看脚本内容。仅当用户确认信任该来源后，方可继续执行。

Linux 与 macOS

curl -sSL https://get.mobazha.org/install | bash

该命令会将 mobazha 二进制文件（以及用于自动更新的 mobazha-launcher）下载至 ~/.local/bin/，并以后台服务形式启动商店。

Windows

1. 访问 https://mobazha.org/download
2. 下载适用于 Windows 的 .zip 文件
3. 解压压缩包
4. 双击 mobazha-tray.exe 启动应用

Windows 桌面应用包含系统托盘图标，并会在启动时自动打开浏览器，跳转至商店管理后台。

安装器执行的操作

1. 检测您的操作系统与架构（linux/darwin，amd64/arm64）
2. 从 GitHub Releases 下载匹配的二进制文件
3. 校验 SHA-256 校验和
4. 将二进制文件放置于 ~/.local/bin/（或通过 --dir 指定的自定义路径）
5. 如可用，则下载启动器二进制文件（提供崩溃恢复与自动更新能力）
6. 注册并启动为后台服务（除非传入 --no-start 参数）

安装完成后，商店可通过 http://localhost:5102 访问（VPS 场景下则为 http://:5102）。

运行您的商店

前台模式

mobazha start

商店 API 与 Web 管理界面默认运行在端口 5102：即 http://localhost:5102。

后台服务模式（推荐）

安装器会自动注册服务。您可使用以下命令进行管理：

mobazha service status     # 检查服务是否正在运行
mobazha service stop       # 停止服务
mobazha service start      # 启动服务
mobazha service install    # 重新安装 / 重新注册服务
mobazha service uninstall  # 卸载服务

在 Linux 上使用 systemd（尽可能采用用户态模式），在 macOS 上使用 launchd。

使用自定义域名

原生二进制文件本身不包含反向代理功能。若需通过 HTTPS 使用自定义域名，请改用 独立 Docker 部署方案（参见 standalone-setup 技能），或手动在端口 5102 前配置反向代理（如 Caddy、Nginx）。

安装选项

备份

mobazha backup -o ~/mobazha-backup.tar.gz

卸载

移除二进制文件与服务（保留您的商店数据）：

curl -sSL https://get.mobazha.org/install | bash -s -- --uninstall

彻底清除所有内容（包括数据）：

curl -sSL https://get.mobazha.org/install | bash -s -- --uninstall --purge

平台说明

macOS

• 通过 curl | bash 方式安装，绕过 Gatekeeper 机制（无需 Apple 开发者签名）
• 启动器以 launchd LaunchAgent 形式注册，实现登录时自动启动
• 同时支持 Apple Silicon（arm64）与 Intel（amd64）架构

Linux ARM64

• 可在 Raspberry Pi 4+ 及 ARM 架构的 VPS 实例上正常运行
• 使用相同的安装命令 —— 安装脚本会自动识别架构

在 NAT 后运行

• 基础功能无需配置端口转发
• 您的商店仍可通过 Mobazha P2P 网络被访问
• 如需直接对外提供公开 URL，建议使用带域名的 独立 Docker 部署方案，或启用 Tor 覆盖网络

安装后操作

1. 打开 http://localhost:5102/admin（VPS 场景下为 http://:5102/admin）
2. 完成 初始化向导 —— 设置管理员密码、商店名称、可见性、地区/货币（完整流程请参阅 store-onboarding 技能）
3. 添加商品并开始销售
4. （可选）通过 MCP 将您的 AI agent 连接到商店 —— 参见 store-mcp-connect 技能

故障排查

安装后找不到二进制文件

请确保 ~/.local/bin 已加入您的 PATH 环境变量：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

权限被拒绝

安装器需要对安装目录具有写入权限。您可通过 --dir 指定一个可写的路径，或以具备相应权限的用户身份运行安装命令。

macOS “未验证开发者” 警告

使用 curl | bash 安装方式时不应出现此警告。若您是直接运行已下载的二进制文件，请执行：

xattr -d com.apple.quarantine ./mobazha

查看服务日志

# Linux
journalctl --user -u mobazha -f

# macOS
tail -f ~/Library/Logs/Mobazha/mobazha.log