Support

支持中心:接入、排查与账务自助指南

按顺序走完 6 步接入清单,多数问题不需要提交工单。查不到答案时,工作日工单首响 30 分钟内,严重故障通道 7×24 在线。

快速上手 连接排查 系统与环境 CI/CD 接入 计费与账务 服务状态 工单与 SLA
Quick Start

快速上手:从收到凭据到接入,6 步

下单后平均 4 分钟,控制台会推送一封含 IP、用户名与初始密钥的开通邮件。按以下顺序操作,首次接入通常在 3 分钟内完成。

保存凭据并设定密钥权限

下载邮件附件中的私钥 m4rent_ed25519,放入 ~/.ssh/,权限必须是 600,否则 SSH 会拒绝使用。

chmod 600 ~/.ssh/m4rent_ed25519

首次 SSH 登录

替换为开通邮件里的实际 IP。默认用户 m4rent 具备 sudo 权限,首登会要求确认主机指纹。

ssh -i ~/.ssh/m4rent_ed25519 m4rent@203.0.113.10

修改初始口令

初始随机口令仅用于屏幕共享与 sudo。登录后立即改为自己的强口令,再在控制台里标记「凭据已轮换」。

passwd

开启 VNC 隧道

屏幕共享端口 5900 默认不对公网开放,通过 SSH 隧道转发到本机后再连接,避免明文暴露。

ssh -i ~/.ssh/m4rent_ed25519 \
  -L 5901:localhost:5900 -N m4rent@203.0.113.10

连接屏幕共享

在本机 macOS 上打开「屏幕共享」或任意 VNC 客户端,地址填隧道本地端。账号 m4rent,口令为上一步修改后的口令。

open vnc://localhost:5901

核对系统与预装环境

确认 macOS 版本、Xcode 与 Homebrew 是否符合预期;版本不符可在控制台一键重装,约 15 分钟完成。

sw_vers && xcodebuild -version && brew -v

安全基线:全部节点默认关闭 SSH 密码登录、仅允许密钥认证,并预置 fail2ban。改动 sshd_config 前先在控制台创建一次快照,配置错误可 5 分钟内回滚。

Troubleshooting

连接问题排查对照表

按「症状 → 定位命令 → 处理」三列执行。表内方法覆盖了工单系统里约 70% 的连接类问题。

症状 先执行的定位命令 最可能原因与处理
SSH 连接超时 ping + nc -zv IP 22 本地网络封锁 22 端口:改用备用端口 2222(全节点同时监听)
Permission denied (publickey) ssh -v 查看握手日志 私钥权限或路径不对:chmod 600,并用 -i 显式指定密钥文件
WARNING: UNPROTECTED PRIVATE KEY FILE ls -l ~/.ssh/m4rent_ed25519 权限过宽:执行 chmod 600 后重试,不要放在同步网盘目录里
VNC 能连上但黑屏 SSH 登录后 who 确认会话 无活动图形会话:在控制台点「唤醒显示」,或执行 sudo caffeinate -u -t 5
VNC 提示口令错误 SSH 登录验证口令是否可用 屏幕共享用的是系统口令而非 SSH 密钥:用 passwd 重设后重连
连接频繁断开 ping -c 20 IP 看丢包率 跨境链路抖动:客户端加 ServerAliveInterval 30,或换更近的节点
REMOTE HOST IDENTIFICATION HAS CHANGED 核对控制台主机详情页指纹 刚做过重装,指纹已更新:ssh-keygen -R IP 清除旧记录后重连

排查前先看控制台主机详情页的电源与网络指示:主机处于「重装中」状态时,以上全部连接方式都会暂时不可用,属预期行为。

System

系统与环境:重装、切换版本、预装清单

重装 macOS

进入控制台 → 主机详情 → 「重装系统」,选择镜像后确认。重装会格式化全盘,平均耗时 15 分钟,完成后邮件推送新的主机指纹与初始口令。重装不改变 IP,不额外计费。

重装前记得导出数据或创建快照。

切换系统版本

全系机型为 M4 与 M4 Pro,受硬件限制仅提供 macOS 15 起的镜像。降级到硬件不支持的版本无法通过重装实现,选型时请先核对目标 Xcode 的系统要求。

查看各机型可选镜像 →

Xcode 与 Homebrew 预装

全部镜像预装 Homebrew、Git 与 Xcode Command Line Tools;「开发镜像」额外预装最近两个正式版 Xcode(可用 xcode-select -s 切换)。需要历史版本时,用 xcodes install 自行安装,机房到镜像源带宽 1Gbps,一个 Xcode 包约 8 分钟下完。

Xcode 许可协议在首次使用时需自行接受。

CI/CD

CI/CD 接入:注册 self-hosted runner

独享物理机不做虚拟化,构建缓存与模拟器状态在任务间保留,iOS 增量构建通常比托管 runner 快 30% 以上。以下为两大平台的注册要点。

GitHub Actions

在仓库 Settings → Actions → Runners 获取 token 后,SSH 到主机执行:

mkdir actions-runner && cd actions-runner
curl -o runner.tar.gz -L \
  "$(gh api /repos/OWNER/REPO/actions/runners/downloads \
  --jq '.[]|select(.os=="osx" and .architecture=="arm64").download_url')"
tar xzf runner.tar.gz
./config.sh --url REPO_URL --token YOUR_TOKEN --labels macos,arm64
./svc.sh install && ./svc.sh start
  • 用 ./svc.sh install 注册为 LaunchDaemon,重启后自动拉起;
  • workflow 里写 runs-on: [self-hosted, macos, arm64];
  • 单机建议并发 1,Xcode 构建吃满全部核心时并发反而更慢。

GitLab Runner

Homebrew 安装后用项目的 registration token 注册,executor 选 shell:

brew install gitlab-runner
gitlab-runner register \
  --executor shell \
  --url GITLAB_URL --token YOUR_TOKEN \
  --tag-list "macos,arm64"
brew services start gitlab-runner
  • shell executor 直接复用主机的 Xcode 与签名证书,无容器开销;
  • 把 concurrent 保持为 1,并给 job 配置 timeout 防挂死;
  • 证书与 provisioning profile 建议存 CI 变量,构建时注入临时钥匙串。

构建农场规模超过 5 台时可申请批量价与统一管理面板,详见 企业与批量采购通道。

Billing

计费与账务规则

账单周期怎么计算?

按天计费以开通时刻起算,每 24 小时为一个计费日;按周 / 月 / 季为预付整期。同一自然月内,日付累计费用达到对应机型月付价(如 M4R M 为 $203.9)即自动封顶,超出部分不再扣费。账单与用量明细在控制台 → 账务页实时可查。

如何申请发票?

控制台 → 账务 → 「申请发票」,填写抬头与税号后提交,电子发票 3 个工作日内发送到账户邮箱。支持按单笔或按自然月合并开具;企业客户需要纸质发票或合同盖章件的,走 企业通道 处理。

退款条件是什么?

按天付费的订单开通后不退。按月及以上周期的订单,开通 72 小时内可申请全额退款(需未发生滥用行为);超过 72 小时后按剩余整月折算退还,已用月按月付单价计。因 M4Rent 侧故障导致的不可用,按 SLA 折算代金券赔付,不占用退款额度。

到期后数据保留多久?

订单到期后主机停机并保留数据 72 小时,期间续费即原样恢复;超过 72 小时执行全盘擦除,不可恢复。快照随主机同步保留,擦除时一并删除。关键数据请在到期前自行导出——快照是辅助手段,不能替代你自己的备份。

升配怎么算差价?

在控制台发起升配,按目标机型与当前机型的日均价差 × 剩余天数补差价,数据整盘迁移到新机,迁移过程约 20 分钟即可重新上线。只支持向上升配;降配需在到期后重新下单。各档价格见 方案与价格页。

Status

服务状态与近 90 天可用率

实时状态每 5 分钟刷新一次,详细事件时间线在控制台状态页。

节点 区域代码 当前状态 近 90 天可用率 监测探针延迟中位数
东京 JP 运行正常 99.98% 34 ms
新加坡 SG 运行正常 99.97% 68 ms
香港 HK 运行正常 99.95% 21 ms
硅谷 US-W 运行正常 99.99% 128 ms

可用率按分钟粒度统计,节点全年 365 天不间断运行,不安排停机。月度可用性目标 99.9%,赔付规则见 服务条款。延迟为全球多地监测探针到该节点的中位数。

SLA

工单与响应时限

30 min
工作日工单首次响应(GMT+8 9:00–24:00)
7×24
严重故障通道:主机不可达、节点级中断,全天候受理
4 h
硬件故障目标恢复时限,含整机替换与数据迁移
级别 定义 首响时限 受理时段
P1 严重 主机不可达、节点级网络中断、数据风险 15 min 7×24
P2 高 性能明显劣化、单项功能不可用 30 min 工作时段
P3 一般 使用咨询、配置协助、账务问题 2 h 工作时段

提交入口:控制台工单系统(推荐,自动关联主机上下文)或邮件 support@m4rent.com。售前与企业采购问题走 联系页的分级通道,响应更快。

Docs

本页没覆盖到?知识库里还有 80+ 篇文档

登录控制台打开完整知识库:逐版本的 Xcode 兼容矩阵、各语言运行时安装指引、网络与安全加固手册,全部与产品同步更新。

打开控制台知识库 立即租用 Mac mini