chore: quickstart startup flow

Author: h3zh1

docs/getting-started.md

@@ -21,7 +21,7 @@ Release 中的主要二进制如下：
 首次启动可使用交互式向导：
 
 ```bash
-./malice_network_linux_amd64 --quickstart
+./malice-network_linux_amd64 --quickstart
 ```
 
 向导会生成初始化所需的核心配置：
@@ -35,19 +35,25 @@ Release 中的主要二进制如下：
 
 ### 直接启动
 
-已从 `server/config.example.yaml` 复制出本地 `config.yaml` 后，可直接启动：
+已有 `config.yaml`，或者让程序自动生成默认配置后，可直接启动：
 
 ```bash
-./malice_network_linux_amd64 -i <public-ip>
+./malice-network_linux_amd64 -i <public-ip>
 ```
 
+默认启动时的初始化行为：
+
+- 如果配置文件不存在，且当前是交互终端，程序会先询问是否进入 quickstart 向导
+- 如果配置文件不存在，且当前不是交互终端，程序会直接写入默认 `config.yaml` 并继续正常启动
+- 如果显式传入 `--quickstart`，则直接进入向导模式，而不是等默认启动时再判断
+
 常用参数：
 
 - `-c, --config`: 指定配置文件路径，默认是 `config.yaml`
 - `-i, --ip`: 覆盖配置里的外网 IP
 - `--server-only`: 只启动 server
 - `--listener-only`: 只启动 listener
-- `--quickstart`: 仅在配置文件不存在时运行初始化向导
+- `--quickstart`: 显式进入交互式初始化向导
 - `--debug`: 打开 debug 日志
 
 ### 首次启动生成的文件
@@ -58,6 +64,13 @@ Release 中的主要二进制如下：
 - `admin_<server-ip>.auth`: client 登录凭证
 - `listener.auth`: 默认 listener 的 mTLS 凭证
 
+如果你使用安装脚本并跳过了 `systemd`，推荐在安装目录中手动启动：
+
+```bash
+cd /opt/iom/malice-network
+./malice-network_linux_amd64 -i <public-ip>
+```
+
 ## 3. 登录 Client
 
 将 `admin_<server-ip>.auth` 放到 client 可访问的位置后执行：

docs/operations/deployment.md

@@ -37,9 +37,9 @@ sudo -E bash install.sh
 
 脚本会提示输入：
 
-1. 安装路径（默认 `/iom`）：
+1. 安装路径（默认 `/opt/iom`）：
    ```
-   Please input the base directory for the installation [default: /iom]:
+   Please input the base directory for the installation [default: /opt/iom]:
    ```
 
 2. IP 地址（自动检测）：
@@ -48,11 +48,22 @@ sudo -E bash install.sh
    ```
 
 **安装脚本自动完成：**
-1. 检查并安装 Docker
-2. 下载并安装 Malice-Network 服务端及客户端
-3. 下载并安装 Malefic 源码及工具
-4. 拉取 Docker 镜像（约 8.21GB）：`ghcr.io/chainreactors/malefic-builder:latest`
-5. 配置并启动服务（基于 systemd）
+1. 检查基础依赖（`curl`、`unzip`）
+2. 下载并安装 Malice Network 服务端及客户端
+3. 下载 `malefic.zip`，并解压到 `./malefic/source_code`
+4. 拉取 Docker 镜像：`ghcr.io/chainreactors/malefic-builder:latest`
+5. 可选配置并启动 systemd 服务；如跳过，则输出手动启动命令
+
+**安装完成后的工作目录结构：**
+
+```text
+<base-dir>/malice-network/
+├── malice-network_linux_amd64
+├── malice_network_linux_amd64 -> malice-network_linux_amd64
+├── iom_linux_amd64
+└── malefic/
+    └── source_code/
+```
 
 ### 下载 Release 部署
 
@@ -61,16 +72,18 @@ Windows 或 macOS 系统部署 Server，从 [Releases](https://github.com/chainr
 - `iom_*` - Client 端
 - `malice_network_*` - Server 端
 
+如果你使用安装脚本，脚本会把 Linux 服务端二进制归一命名为 `malice-network_linux_amd64`；如果你是手动下载 release，请按实际文件名执行。
+
 启动 Server：
 
 ```bash
-./malice_network_linux_amd64
+./malice-network_linux_amd64
 ```
 
 指定 IP 启动（Client 可访问的 IP，如公网 IP）：
 
 ```bash
-./malice_network_linux_amd64 -i 123.123.123.123
+./malice-network_linux_amd64 -i 123.123.123.123
 ```
 
 ### Server 启动参数
@@ -136,6 +149,13 @@ Listener 和编译配置详见 [listeners.md](server/listeners.md) 和 [build.md
 
 ## 启动 Client
 
+如果安装时跳过了 systemd，可手动启动：
+
+```bash
+cd /opt/iom/malice-network
+./malice-network_linux_amd64 -i <server-ip>
+```
+
 Server 启动后生成两个配置文件：
 - `listener.auth` - Listener 凭证
 - `admin_[server_ip].auth` - Client 登录凭证

docs/server/index.md

@@ -32,7 +32,7 @@ Server 是 malice-network 的控制核心，职责包括：
 | `./malice-network --server-only` | 仅启动 Server，不启动 Listener |
 | `./malice-network --listener-only` | 仅启动 Listener，独立部署时使用 |
 | `./malice-network --daemon` | 以守护进程模式运行 |
-| `./malice-network --quickstart` | 交互式配置向导，引导完成初始配置 |
+| `./malice-network --quickstart` | 显式进入交互式配置向导，引导完成初始配置 |
 
 | 参数 | 说明 |
 |------|------|
@@ -41,6 +41,12 @@ Server 是 malice-network 的控制核心，职责包括：
 | `--debug` | 开启 debug 日志 |
 | `--opsec` | 启用 OPSEC 模式 |
 
+当默认启动时，如果配置文件不存在：
+
+- 交互终端会先提示是否进入 quickstart
+- 非交互环境会直接生成默认配置并继续启动
+- 只有显式传入 `--quickstart` 时，才会强制进入向导
+
 !!! tip "部署指南"
     完整的部署流程见 [部署操作指南](../operations/deployment.md)。
 

docs/server/quickstart.md

@@ -12,6 +12,8 @@
 - `malice_network_darwin_arm64` — macOS Apple Silicon
 - `malice_network_windows_amd64.exe` — Windows x86_64
 
+如果你使用安装脚本，脚本会把 Linux 服务端二进制归一命名为 `malice-network_linux_amd64`。如果你是手动下载 release，请按实际下载下来的文件名执行。
+
 !!! tip "网络问题"
     国内服务器下载 GitHub release 可能超时，建议配置代理：
     ```bash
@@ -22,12 +24,18 @@
 ## 首次启动
 
 ```bash
-./malice-network -i <公网IP>
+./malice-network_linux_amd64 -i <公网IP>
 ```
 
 !!! important "IP 设置"
     `-i` 参数需要设置为 Client 可访问到的 IP 地址。公网服务器设置为公网 IP，内网环境设置为内网 IP。
 
+如果当前还没有配置文件，默认启动会按下面的规则处理：
+
+- **交互终端**：先提示你是否进入 quickstart 向导
+- **非交互环境**（比如 systemd、无 PTY 的脚本环境）：直接生成默认 `config.yaml`，然后继续正常启动
+- **显式传入 `--quickstart`**：直接进入向导模式
+
 首次启动后，Server 会自动完成：
 
 1. 生成默认配置文件 `config.yaml`
@@ -46,25 +54,31 @@
 首次使用或需要重新配置时，可以使用交互式向导：
 
 ```bash
-./malice-network --quickstart
+./malice-network_linux_amd64 --quickstart
 ```
 
 向导会引导完成 IP、端口、构建源等基础配置。
 
+注意：
+
+- `--quickstart` 是显式入口，不依赖“配置文件是否存在”来触发
+- quickstart 基于 TUI，适合交互式终端，不适合 systemd 这类无 PTY 环境
+- 如果目标配置文件已经存在，quickstart 不会覆盖原文件
+
 ## 使用安装脚本（Linux）
 
-!!! info "安装脚本会自动完成 Docker 安装、Server/Client 下载、构建镜像拉取和 systemd 配置"
+!!! info "安装脚本会自动完成 Docker 安装、Server/Client 下载、malefic.zip 解压，并可选配置 systemd"
 
 ```bash
 curl -L "https://raw.githubusercontent.com/chainreactors/malice-network/master/install.sh" | sudo bash
 ```
 
 安装脚本会交互式询问：
 
-- **安装路径**：默认 `/iom`
+- **安装路径**：默认 `/opt/iom`
 - **IP 地址**：自动检测，可手动修改
 
-安装完成后 Server 会以 systemd 服务运行。
+安装完成后，脚本会询问是否安装并启动 systemd 服务；如果跳过，会直接输出手动启动命令。使用 systemd 时，服务端会走默认启动路径，不会自动进入 quickstart 向导。
 
 ## 防火墙配置
 
@@ -99,11 +113,11 @@ pipeline        # 查看 Pipeline 列表
 
 | 模式 | 命令 | 场景 |
 |------|------|------|
-| 标准启动 | `./malice-network -i <ip>` | Server + Listener 一起运行 |
-| 仅 Server | `./malice-network --server-only` | Listener 独立部署时 |
-| 仅 Listener | `./malice-network --listener-only` | 独立 Listener 节点 |
-| 守护进程 | `./malice-network --daemon` | 后台运行 |
-| 交互向导 | `./malice-network --quickstart` | 首次配置 |
+| 标准启动 | `./malice-network_linux_amd64 -i <ip>` | Server + Listener 一起运行 |
+| 仅 Server | `./malice-network_linux_amd64 --server-only` | Listener 独立部署时 |
+| 仅 Listener | `./malice-network_linux_amd64 --listener-only` | 独立 Listener 节点 |
+| 守护进程 | `./malice-network_linux_amd64 --daemon` | 后台运行 |
+| 交互向导 | `./malice-network_linux_amd64 --quickstart` | 首次配置 |
 
 ## 下一步