> For the complete documentation index, see [llms.txt](https://scx.gitbook.io/sc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://scx.gitbook.io/sc/backend-deploy-docs/sc-backend.md).

# 后端部署指南

{% hint style="warning" %}
我们最近对于后端程序作出了大型改动，同时我们正在升级我们的后端部署流程，老版本的 Miaospeed SC 后端（版本 <= 2.2.0）将不会与此流程兼容。请参照我们的[老版本卸载指南](/sc/backend-deploy-docs/sc-backend-old-uninstall.md)对老版本进行完全卸载后再部署新版本。
{% endhint %}

再一次感谢您选择 Miaoko+ 。

Miaoko+ 使用由我们自己维护的 Miaospeed 后端，我们推荐您使用我们的专用后端。本教程将帮助您在您的机器上快速部署 Miaoko+ Miaospeed 后端。

由我们维护的 Miaospeed 目前支持 **Linux ,** **Windows和 MacOS** 三个系统。受篇幅限制，我们只讲述在Linux 和 Windows下的常见部署方式。如需要其它安装方式，您可以选择在 [此处](https://github.com/scpj/ms-sc-destribution/releases) 自行下载二进制或者在客服协助下安装。

从 2.3.0 版本起，由 SpeedCentre 维护的 Miaospeed 后端启动方式将不兼容市面上的主流 Miaospeed 后端。如果想使用您自己或者第三方的测试机器人对接您的后端，请联系我们的技术人员以获取详情。

请获取你的后端密钥后，根据系统选择对应教程。

* [Linux](#linux-bu-shu-docker)
* [Windows](#windows-bu-shu-jin-zhi-chi-frp)

***

### 🚀 Linux 部署 (Docker)

#### 1. 安装 Docker

如果你还没有安装 Docker，请前往 [Docker 安装教程](https://docs.docker.com/engine/install/) 根据系统选择安装方式。

安装完成后，建议确认是否安装成功：

```bash
docker -v
docker compose version
```

***

#### 2. 拉取镜像

`miaospeed` 的官方镜像地址为：

```
ghcr.io/scpj/miaospeed_sc
```

对于后端在国内的用户。我们推荐使用镜像站拉取。这里是一份[国内docker状态监控列表](https://status.anye.xyz/)，您可以挑选一个您喜欢的镜像拉取。

**请注意：这份列表中的网站指向的是 docker hub 的镜像，请点开镜像详情页查找该镜像站的 ghcr 镜像。**

另外，使用镜像站后请在拉取/启动/更新等场景下把镜像名统一替换为包含镜像站的名称。例如您使用的镜像站为 `ghcr.m.ixdev.cn` ，则拉取命令改为 `docker pull ghcr.m.ixdev.cn/scpj/miaospeed_sc:latest`，启动命令也需要将镜像名修改为相应的名称。

将最新的定制版 Miaospeed 镜像拉取至本地。拉取命令：

```bash
sudo docker pull ghcr.io/scpj/miaospeed_sc:latest
```

***

#### 3. 启动方式

{% hint style="warning" %}
为了提升测速体验，版本大于等于 2.4.0 的后端暂不支持传统 Miaospeed 的传统服务器直接监听功能，如果您需要将该后端接入到其他测速 Bot，您可以联系我们或者使用 SpeedCentre+ Copilot Miaospeed API调用后端。
{% endhint %}

工作人员会提供后端密钥。\
您可以直接选择使用命令启动，启动命令（直接 `docker run`）：

```bash
sudo docker run -idt --restart=always -v ./miaospeed_data:/opt/data --name miaospeed \
  ghcr.io/scpj/miaospeed_sc:latest \
  server --key <你的后端密钥>
```

您也可以使用 `docker compose` 。先创建一个 Miaospeed 文件夹，在文件夹下新建 `docker-compose.yml` ，在中间填入：

```yaml
services:
  miaospeed:
    image: ghcr.io/scpj/miaospeed_sc:latest
    container_name: miaospeed
    restart: always
    volumes:
      - ./miaospeed_data:/opt/data
    command: server --key <你的后端密钥>
```

保存后启动：

```bash
sudo docker compose up -d
```

***

#### 4. 验证启动

运行 `docker logs miaospeed`，出现以下字样即算启动成功，其它情况请咨询技术支持：

```bash
# FRP版本
root ➜ / $ sudo docker logs miaospeed
WARN | 2025-08-28T10:01:12Z | MiaoSpeed SpeedTesting Client SC-2.3.0
WARN | 2025-08-28T10:01:12Z | Maxmind Database | No maxmind database specified, using embeded database
WARN | 2025-08-28T10:01:12Z | MiaoSpeed Server | Advanced Frp Feature Enabled
WARN | 2025-08-28T10:01:12Z | MiaoSpeed Server | Server launched successfully.
2025-08-28 10:01:12.821 [I] [client/service.go:296] try to connect to server...
2025-08-28 10:01:15.379 [I] [client/service.go:288] [c405bc0cdee3af8a] login to server success.
2025-08-28 10:01:15.570 [I] [client/control.go:169] [c405bc0cdee3af8a] start proxy success

# 直接监听版本
root ➜ / $ sudo docker logs miaospeed
WARN | 2025-08-28T10:01:12Z | MiaoSpeed SpeedTesting Client SC-2.3.0
WARN | 2025-08-28T10:01:12Z | Maxmind Database | No maxmind database specified, using embeded database
```

***

#### 5. 升级镜像

在 2.3.0 版本后，我们的后端提供自更新功能。不过我们仍建议您定期升级镜像。

我们的后端版本有时需要升级，升级只需拉取最新镜像并重启容器即可：

```bash
sudo docker pull ghcr.io/scpj/miaospeed_sc:latest
sudo docker stop miaospeed && docker rm miaospeed
sudo docker compose up -d   # 如果你用 compose
# 或者
sudo docker run ...(剩余命令)         # 如果你用 run
```

***

### 🪟 Windows 部署

鉴于大部分只使用 Windows 的用户没有使用 Docker的习惯，因此我们在这里仅提供快速安装程序。如果您在 Windows 上安装了 Docker Desktop，您也可以使用 Docker 部署，但是我们仍然推荐您使用占用低的懒人脚本。

**重要提示：由于程序未签名，杀软和 windows smartscreen 可能会将安装程序和主程序误报，请在安装时将安装程序列入白名单或者关闭杀毒软件。**

#### 1. 下载安装程序

在[此处](https://scapi-vc.voi.moe/api/ms-installer)下载安装程序。

#### 2. 运行安装程序

运行安装程序，程序会引导你输入后端密钥，程序会自动完成安装流程。

<figure><img src="https://content.gitbook.com/content/LAVSWReLAyQHcKIkTIuu/blobs/e4zG4Dn6f0DYqrBXsvZL/image.png" alt=""><figcaption></figcaption></figure>

#### 3. 完成安装。

安装完成后，如果要确认后端是否在运行，请 Win + R 并运行 `msup logs` 在目录下找到 `miaospeed-xxxx.log` ，出现 `start proxy seccess` 即为启动成功。

<figure><img src="https://content.gitbook.com/content/LAVSWReLAyQHcKIkTIuu/blobs/A9iTGwn3eLG2p8Wcjmc3/image.png" alt=""><figcaption></figcaption></figure>

***

✅ 至此，`miaospeed` 完成部署。