安装与部署指南

July 3, 2026 · View on GitHub

设备侧一键安装 / 升级

在目标设备上以 root 执行：

curl -fsSL https://raw.githubusercontent.com/3899/SimAdmin/main/install_latest.sh | sh

国内网络环境

curl -fsSL https://gh-proxy.com/https://raw.githubusercontent.com/3899/SimAdmin/main/install_latest.sh | sh

可选环境变量

curl -fsSL https://raw.githubusercontent.com/3899/SimAdmin/main/install_latest.sh \
  | REPO=3899/SimAdmin INSTALL_DIR=/opt/simadmin SERVICE_NAME=simadmin sh

安装脚本动作说明

  • 从 GitHub Release 下载 simadmin.tar.gz。
  • 安装后端二进制到 /opt/simadmin/simadmin。
  • 安装前端到 /opt/simadmin/www。
  • 安装并启用 simadmin.service。
  • 安装并启用 simadmin-modem-recovery.service。
  • 配置 NetworkManager 忽略 wwan* 接口，避免与 SimAdmin 抢占蜂窝连接管理。

访问管理后台

安装成功并运行服务后，您可以通过浏览器访问管理后台：

  • 访问地址：http://<设备IP>:3000
  • 密码设定：SimAdmin 未设默认初始密码。首次访问时将自动跳转到 /login 的“设置管理员密码”页面，设定强密码后会自动登录并进入系统。

SimAdmin 采用单管理员登录模式，不包含多用户和权限细分系统。首次运行配置要求如下：

密码规则

  • 8-64 个字符。
  • 只能使用英文字母、数字和符号，不允许空格或中文。
  • 至少包含两类字符，例如字母 + 数字、字母 + 符号或数字 + 符号。

关闭与调整密码保护

系统默认开启密码安全保护。如果您希望在局域网内免密直接使用，或需要修改密码的强度规则：

  1. 关闭密码保护：登录后台后，前往 「系统配置 - 安全性设置」 页面，将“密码保护”开关关闭并保存。在此之后，访问 Web 后台将不再要求输入密码。
  2. 调整强度规则：在 「系统配置 - 安全性设置」 页面中，可以自定义设置密码的最小长度（1-64 位）以及是否强制要求包含英文字母、数字和符号等强度校验规则。

忘记/清空密码

忘记密码时，可通过 SSH 登录目标设备后执行交互式重置：

/opt/simadmin/simadmin auth reset-password

如需清除管理员密码并让 Web UI 下次重新进入首次设置：

/opt/simadmin/simadmin auth clear

如果使用了自定义安装目录，请将 /opt/simadmin/simadmin 替换为实际后端二进制路径。

设备侧一键卸载

默认彻底卸载，删除服务、程序文件、前端文件、OTA 临时目录、NetworkManager 配置以及用户数据：

curl -fsSL https://raw.githubusercontent.com/3899/SimAdmin/main/uninstall.sh | sh

国内网络环境

curl -fsSL https://gh-proxy.com/https://raw.githubusercontent.com/3899/SimAdmin/main/uninstall.sh | sh

保留用户数据卸载

如需保留短信数据库和配置文件：

curl -fsSL https://raw.githubusercontent.com/3899/SimAdmin/main/uninstall.sh \
  | sh -s -- --keep-user-data

自定义环境卸载

自定义安装路径或服务名时，需要和安装时保持一致：

curl -fsSL https://raw.githubusercontent.com/3899/SimAdmin/main/uninstall.sh \
  | INSTALL_DIR=/opt/simadmin SERVICE_NAME=simadmin sh -s -- --keep-user-data

卸载脚本参数说明

参数说明
--purge删除全部 SimAdmin 文件和用户数据，默认行为
--keep-user-data保留 /opt/simadmin/data.db、SQLite sidecar 文件和配置文件
--install-dir PATH指定安装目录，默认 /opt/simadmin
--service-name NAME指定主服务名，默认 simadmin

卸载脚本动作说明

  • 停止并禁用 simadmin.service。
  • 停止并禁用 simadmin-modem-recovery.service。
  • 删除 systemd 单元文件并执行 daemon-reload / reset-failed。
  • 删除 /usr/local/bin/simadmin-modem-recovery.sh。
  • 删除 /etc/NetworkManager/conf.d/99-simadmin-unmanaged-modem.conf，并在 NetworkManager 运行时重启它。
  • 删除 /tmp/ota_staging。
  • 默认删除 /opt/simadmin 和 /data/config.json；使用 --keep-user-data 时保留用户数据。