> 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-old.md).

# 后端部署指南（已弃用）

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

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

请根据系统选择对应教程。

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

***

### 🚀 Linux 部署 (Docker)

{% hint style="warning" %}
**请在 root 用户下或加 sudo 前缀操作。**
{% endhint %}

#### 1. 安装 Docker

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

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

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

***

#### 2. 拉取镜像

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

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

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

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

***

#### 3. 启动方式

`miaospeed` 提供两种启动方式：

**🔹 方式一：FRP 版本**

如果您的后端不在公网，我们会使用内网穿透技术访问您的后端，此时需要单独配置。

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

```bash
docker run -idt --name miaospeed \
  ghcr.io/scpj/miaospeed_sc:latest \
  server --token <你的token> --frpkey <你的frpkey>
```

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

```yaml
version: "3"
services:
  miaospeed:
    image: ghcr.io/scpj/miaospeed_sc:latest
    container_name: miaospeed
    restart: always
    command: server --token <你的token> --frpkey <你的frpkey>
```

保存后启动：

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

***

**🔹 方式二：直接监听版本**

如果您的机器在公网可以直接访问，您可以直接启动传统 Miaospeed 服务器，我们会通过公网访问后端。

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

```bash
docker run -d --name miaospeed \
  -p 8765:8765 \
  ghcr.io/scpj/miaospeed_sc \
  server -bind 0.0.0.0:8765 -token <你的token> -mtls
```

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

```yaml
version: "3"
services:
  miaospeed:
    image: ghcr.io/scpj/miaospeed_sc:latest
    container_name: miaospeed
    restart: always
    ports:
      - "8765:8765"
    command: server -bind 0.0.0.0:8765 -token <你的token> -mtls
```

保存后启动：

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

{% hint style="warning" %}
请注意，Docker的端口映射模式是 `宿主机端口:容器端口`，8888:8765 的意思是将容器内端口为 8765 的服务映射到宿主机的 8888 端口，启动参数内bind的端口是 Miaospeed 在容器内的监听端口，如果要修改 Miaospeed 在主机上的监听端口，请修改冒号前面的端口号！
{% endhint %}

***

#### 4. 验证启动

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

```bash
# FRP版本
root ➜ / $ docker logs miaospeed
WARN | 2025-08-28T10:01:12Z | MiaoSpeed SpeedTesting Client SC-2.2.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 ➜ / $ docker logs miaospeed
WARN | 2025-08-28T10:01:12Z | MiaoSpeed SpeedTesting Client SC-2.2.0
WARN | 2025-08-28T10:01:12Z | Maxmind Database | No maxmind database specified, using embeded database
```

***

#### 5. 升级镜像

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

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

***

### 🪟 Windows 部署

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

#### 1. 以管理员身份打开 PowerShell

* 按下 **Win 键**，输入 `powershell`
* 右键点击 **Windows PowerShell** → 选择 **以管理员身份运行**

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

#### 2. 一键安装命令

工作人员会提供 `token` 和 `frpkey`。\
请在管理员 PowerShell 中执行以下命令（替换 `<token>` 和 `<frpkey>`）：

```powershell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Ssl3 -bor [Net.SecurityProtocolType]::Tls -bor [Net.SecurityProtocolType]::Tls11 -bor [Net.SecurityProtocolType]::Tls12;
set-ExecutionPolicy RemoteSigned;
Invoke-WebRequest https://s.miaoko.plus/install_cn.ps1 -OutFile C:\install.ps1;
powershell.exe C:\install.ps1 <token> <frpkey>
```

安装完成后，`miaospeed` 将自动运行。

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

***

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