PasteSpider · 开发者专用轻量级部署工具

为什么是旁载模式

不是拿大炮打蚊子，而是刚好够用

K8S、K3S、Jenkins 这类工具功能强大，但太过庞大，很多小内存服务器无福消受。 PasteSpider 只解决「部署」这一件事，把它做到轻。

K8S / K3S / Jenkins Platform, not a tool

动辄几 GB 内存，2G 小服务器无福消受
一般还得有专门的运维人员
各种配置和资料一大堆，上手与排错成本高
每台服务器都要装一套

            PasteSpider
            旁载模式 · 开发者专用
          
100 个运行容器约占用 300MB
图形界面点点点，2 分钟部署 3 分钟上手
技术栈原生：Nginx 路由 + docker / podman 原生命令
几台公用一套，SSH 局域网通讯与作业

维度	K8S / Jenkins	PasteSpider
内存占用	数 GB	100 个运行容器约 300MB
上手成本	需专职运维	图形点点点，2 分钟部署 3 分钟上手
技术栈	厂商抽象层	技术栈原生：Nginx 路由 + docker / podman 原生命令
故障影响面	平台级	旁载模式，停掉 / 卸载不影响已运行服务
服务器要求	每台都装	几台公用一套，SSH 局域网通讯
费用	—	基础版免费且已开源

Problem

小内存服务器的四个现实问题

官方原话：「这些东西都太过庞大，很多小内存的服务器无福消受，而且对于中小企业来说使用 K8S 等有种拿大炮打蚊子的感觉！」

太重

K8S / K3S / Jenkins 动辄几 GB 内存，2G 内存的小服务器根本带不动。

成本高

中小企业「拿大炮打蚊子」，还得额外配一名专职运维人员。

上手难

各种配置和资料一大堆，学习曲线陡，排错成本同样高。

怕牵连

部署工具和业务服务耦合，工具一挂，业务跟着一起出事。

Solution

旁载模式：旁观者，不进场

旁观者模式，服务运行不基于 PasteSpider。停止或卸载 PasteSpider，不影响其他服务 —— 这是它与所有「平台型」工具最本质的区别。

技术栈原生

接口路由用 Nginx，打包升级用 docker 原生命令（含 podman）。出问题只需查原生文档。

运行安全

旁观者模式，服务运行不基于 PasteSpider，停止或卸载不影响其他服务。

一拖多服务器

不必每台 Linux 都装，几台公用一套，通过 SSH 局域网通讯与作业。

操作简单

点点点图形界面 + 专有管理后台；要自研客户端可访问 /swagger/ 看接口文档。

版本命名规则：V2 = 仅 Docker / Podman；V5 = Docker / Podman / IIS / Systemd / Service。为便于区分，文档中 Linux 的 Service 写作 systemd，Windows 的 Service 写作 service。

Architecture

从项目到服务器的六层链路

所有配置都挂在这条链路上：项目 → 环境 → 服务 → 版本（镜像）→ 容器 / 站点 → 服务器。

1

项目 Project 一个系统，包含一个或多个服务。

2

环境 Environment 测试 / 正式，差异主要在配置，如 appsettings.json 的连接字符串。

3

服务 Service 可以是接口、web 前端、管理端。

4

版本 Image 构建镜像形成的版本，支持回滚；目标版本之下最多保留 5 个镜像。

5

容器 / 站点实际运行单元，支持按服务器分组扩容 / 缩减。

6

服务器 Server Windows / Linux，多台可组成集群（Cluster 组件）。

路由

Nginx 规则由模板渲染，随容器增减动态调整，实现平滑 / 无损升级。

项目网关

对外统一入口。注意：IIS 与 Linux Systemd 模式不支持项目网关。

权限

可拆到「服务 + 环境」粒度，例如张三只能发布商城订单服务。

交互方式

V2 全远程（SSH）；V5 远程 + 本地混合，本地通过 sh / cmd 与 IIS 等交互。

Deployment Modes

PasteSpider 能把你的项目
部署成 5 种形态

V5 起，一个工具覆盖容器化与裸机两类目标。同一份配置语义，不同运行形态，迁移不需要改代码。

Docker

docker run / build

容器化部署，直接走 docker 原生命令构建与升级。

Podman

与 Docker 同规则

兼容 Podman 原生命令，规则与 Docker 完全一致。

IIS

Windows

IIS 站点 + 程序池，支持动态表单配置、HTTPS 证书绑定。

Systemd

Linux

Systemd 服务，服务名 / 程序名动态配置，journalctl 看日志。

Windows Service

Windows

以 service 形式运行，支持 .bat 启停脚本。

别搞混两件事：上面 5 种是 PasteSpider 能把你的项目部署成的形态；而 PasteSpider 自身只有 3 种运行方式，见下一节。另外，项目网关在 IIS 与 Linux Systemd 模式下不支持。

How PasteSpider Runs

PasteSpider 自身，只有 3 种运行方式

.NET 跨平台，依赖 .NET Core 支持 CentOS / RedHat / Ubuntu。容器模式与 Windows Service 为 .NET 8.0，Linux Systemd 为 .NET 6.0。

方式 01

容器内运行

推荐方式，5 分钟完成安装。25.04 起容器内监听 8080（旧版 80），映射端口时注意区分。

Docker / Podman

方式 02

Linux Systemd

下载 zip 或安装包，配置 appsettings.json 后交由 systemd 托管。

.NET 6.0

方式 03

Windows Service

以 Windows 服务形式常驻，使用 win.service.start.bat 启停。

.NET 8.0

File Modes

三种文件模式，覆盖全部交付形态

不管你交付的是一堆静态资源、一个 publish 目录，还是一份源码，都能走同一条流水线。

01

静态文件模式

适用于 web / manage / h5 等纯静态资源，指定路径发布即可，Nginx 直接指向该目录。

指定路径发布 Nginx 指向

02

发布模式

最常用。开发机 publish 后上传到服务器指定目录运行，差量同步避免重复传输。

publish 差量同步重启运行

03

源码模式

配合 Git / SVN，提交源码后自动拉取 → 编译 → 发布 → 构建镜像 → 升级容器。

提交源码编译构建镜像

配套 PasteSpiderFile：Windows 客户端做差量文件同步，支持一键发布、忽略过滤、失败中断。同步过滤规则可在 doc/spider/asyncConfig 中配置。

Advantages

官方列出的 12 项优势

以下小标题与要点均来自官方专题文档，未做增补。

01

节省资源

一拖多服务器模式，100 个运行容器约占用 300MB；不必每台 Linux 都装，几台公用一套，SSH 局域网通讯与作业。

02

技术栈原生

接口路由用 Nginx，打包升级用 docker 原生命令（含 podman）；出问题只需查原生文档。

03

运行安全

旁观者模式，服务运行不基于 PasteSpider，停止或卸载 PasteSpider 不影响其他服务。

04

操作简单

点点点图形界面 + 专有管理后台；要自研客户端可访问 /swagger/ 看接口文档，Nginx 规则提供多版本案例文本。

05

多模式支持

静态 web / 发布文件 / 源码编译三种模式，覆盖主流交付方式。

06

数据报表

按历史查看容器运行状况，监测内存泄漏；消息推送走钉钉 / 飞书 WebHook。

07

自动升降

按配置在访问高峰期自动扩容；灰度升级，升级数量小于运行量。

08

GIT / SVN

提交源码即自动编译、构建、部署。

09

占位符宏支持

内置各对象宏（容器 ID、项目配置、配置项、配置文件等）可在执行命令中传递。

10

权限细化

权限拆到服务与环境级，例如张三只能发布商城订单服务。

11

预警通知

服务器剩余硬盘、剩余可用内存、服务高 CPU / 高内存占用预警。

12

使用免费

基础版免费，已开源。

Modules

17 个功能模块，在线文档可查

下列模块与官方在线操作文档目录一一对应。输入模块名、说明或文档路径即可筛选。

项目与服务配置

项目doc/spider/projectInfo

项目代码、存放路径、监听端口、端口映射。

服务doc/spider/serviceInfo

服务模式、前后置命令、升级拆分次数。

项目路由doc/spider/nginxRoute

Nginx 模板渲染，容器增减自动改路由。

服务器doc/spider/linuxInfo

Windows / Linux 服务器接入与对外端口范围。

项目网关doc/spider/bindProjectNetwork

统一对外入口（IIS / systemd 不支持）。

键值 Key-Valdoc/spider/keyValueConfig

键值配置，运行时注入。

交付与同步

私有仓库doc/spider/storeInfo

一键部署私有镜像仓库 Registry。

Git / SVNdoc/spider/codeProject

提交即触发自动编译部署。

同步过滤doc/spider/asyncConfig

文件同步忽略规则，减少错更。

PasteSpiderFiledoc/spider/client

Windows 文件同步客户端，差量升级。

模板doc/spider/templateInfo

IIS 站点、程序池、systemd 文件等模板与宏。

监控与存储

服务器监控doc/spider/monitorLinux

CPU / 内存 / 硬盘 / 持续时间。

服务监控doc/spider/monitorService

容器与站点运行状态、秒链接、秒读取。

OSS 对象存储doc/spider/aliYunOssConfig

阿里云 OSS。

权限与集群

节点doc/spider/slaveInfo

集群节点增删改与状态同步。

服务绑定doc/spider/bindModelLinux

服务与服务器 / 环境的绑定关系。

授权doc/spider/userAuth

账号与项目权限划分。

CI/CD

从提交代码到更新路由，一条流水线走完

所有操作都转为异步任务，支持任务 / 子任务列表与失败步骤排查。容器命名规则：model.code_service.id_app.id_project.id_model.id

1

提交代码

Git / SVN 提交源码

2

拉取源码

服务器端拉取代码

3

编译构建

dotnet build / publish

4

构建镜像

docker build 生成版本

5

启动 / 升级

拉取镜像并替换容器

6

更新路由

Nginx 规则同步

7

完成

任务成功回传

升级拆分次数

10 个容器拆 3 次升级，每次后更新路由，尽量实现无损升级。

灰度发布

升级数量小于当前运行量，先升级一部分观察后再全量。

回滚

在「我的服务 → 镜像」中找到版本直接回滚，可勾选回滚哪些服务器、多少容器。

任务模式

所有操作转为异步任务，支持任务 / 子任务列表与失败步骤排查。

Cluster

用 PasteCluster 让项目快速支持集群

多台服务器不是重复劳动，而是同一份配置的多个落点。

PasteCluster 组件

集群组件 PasteSpider，让项目快速支持集群模式。

部署在宿主服务器

PasteSpider 需部署在宿主服务器上，通过命令与服务器交互。

任务中转

任务经 Cluster 中转到目标服务器执行，完成后通过 WebSocket 下发结果。

动态节点

节点信息可动态编辑，映射到 appsettings.json；状态变化时自动入集群 / 离开集群。

Observability

看得见，才敢自动升降

按历史查看容器运行状况，识别内存泄漏；告警走钉钉 / 飞书 WebHook。

服务器监控

CPU、内存、硬盘、持续时间。

服务监控

容器 / 站点状态、秒链接、秒读取、连接数。

数据报表

历史趋势，识别内存泄漏。

预警通知

服务器剩余硬盘、剩余可用内存、服务高 CPU / 高内存占用预警。

消息推送

钉钉 / 飞书 WebHook，支持分层级（只接收某个服务的通知）与自定义网关。

日志分级

information / warning / error 重新划分；Linux systemd 用 journalctl，IIS 支持日志读取。

Tech Stack

技术栈矩阵，如实列出

不做夸大表述，以下均为官方文档给出的实际依赖。

项	说明
运行时	容器模式与 Windows Service 为 `.NET 8.0`；Linux Systemd 为 `.NET 6.0`
数据库	`MySQL(MariaDB) / SQL Server / PostgreSQL / SQLite`（25.04 起支持多库）
路由	`Nginx`（提供多版本模板文本）
缓存	`Redis`
接口文档	Swagger，访问 `/swagger/`
前端框架	管理端基于 PasteApeart（原 PasteForm）
文档机制	PasteDocument（哪里不会点哪里，字段带 ❓ 可点）
跨平台	依赖 .NET Core 跨平台，支持 CentOS / RedHat / Ubuntu

自家框架反哺自家产品：PasteSpider 的管理端全线改用 PasteApeart —— 又一个实际项目证明了 PasteApeart 框架的实用性。

Quick Start

5 分钟装好，然后打开管理端

推荐用容器方式安装，三种方式任选其一。

1

以容器方式安装推荐

一条 docker run 即可。注意端口：25.04 起容器内监听 8080（旧版 80），所以映射 8900:8080。

2

或者：Linux Systemd 方式

下载 zip / 安装包，配置 appsettings.json，交给 systemd 托管。

3

或者：Windows Service 方式

使用 win.service.start.bat 启停。

4

打开管理端

访问路径 /page/index.html：容器内监听 80，容器外默认 51695。配置文件为 appsettings.json。

docker run · PasteSpider

# 以容器方式安装 PasteSpider（推荐）
docker run -d -p 8900:8080 -v /spider/data:/app/data registry.cn-heyuan.aliyuncs.com/apeart/pastespider:latest

# 容器内监听 8080（25.04 起，旧版为 80），故宿主机映射 8900
# 用 SQLite 必须做路径映射 -v /spider/data:/app/data，否则升级会丢数据

# 管理端：http://<服务器IP>:8900/page/index.html

镜像版本规则：xx.xx.xx.xx = 年.月.日.版本；镜像按月份，如 202504； latest 随时间升级。容器命名规则：model.code_service.id_app.id_project.id_model.id。

Download

下载 PasteSpider

社区版 / 专业版功能不同，基础版免费开源。

平台	文件名	版本	大小	文件码
Linux	`Linux_Service_x64`	V5.25.03.16	57.3MB	`F8B08E71`
Windows	`Windows_Service_x64`	V5.25.03.16	58.7MB	`EA19E3C1`

下载地址： 官方下载页 · Gitee 发行版 · 源码仓库

Ecosystem

同作者的工具箱

PasteSpider 不是孤立的软件，而是一组开发者工具中的一件。

PasteApeart

DTO 元数据驱动 UI + Handler 聚合业务场景的管理端框架（原 PasteForm）。

PasteTimer

定时任务。

PasteBuilder

构建工具。

PasteTemplate

项目模板。

PasteTalk

客服 / 营销系统。

PasteDocument

在线操作文档，「哪里不会点哪里」。

社区	入口
官网	soft.pastecode.cn/welcome/pastespider
操作文档	soft.pastecode.cn/doc/spider/
专题文档	《开发者专用 Linux 容器部署工具介绍》
Gitee	gitee.com/pastecode/PasteSpider
博客园	cnblogs.com/pastespider
CSDN	blog.csdn.net/Apeart
掘金	juejin.cn/user/2126902026878572
知乎	zhihu.com/people/zhi-bo-shi-jie-60
QQ 群	296245685

基础版免费 · 已开源

五分钟上手，小内存服务器也能跑的部署工具

一条 docker run 装好，打开 /page/index.html 就能开始部署。停止或卸载 PasteSpider 都不会影响已经在跑的服务。

立即下载在线文档参与开源

PasteSpider 是部署工具，不是爬虫。

All in Docker / Podman / IIS / Systemd / Service

不是拿大炮打蚊子，而是刚好够用

小内存服务器的四个现实问题

太重

成本高

上手难

怕牵连

旁载模式：旁观者，不进场

技术栈原生

运行安全

一拖多服务器

操作简单

从项目到服务器的六层链路

路由

项目网关

权限

交互方式

PasteSpider 能把你的项目部署成 5 种形态

Docker

Podman

IIS

Systemd

Windows Service

PasteSpider 自身，只有 3 种运行方式

容器内运行

Linux Systemd

Windows Service

三种文件模式，覆盖全部交付形态

静态文件模式

发布模式

源码模式

官方列出的 12 项优势

节省资源

技术栈原生

运行安全

操作简单

多模式支持

数据报表

自动升降

GIT / SVN

占位符宏支持

权限细化

预警通知

使用免费

17 个功能模块，在线文档可查

项目与服务配置

交付与同步

监控与存储

权限与集群

从提交代码到更新路由，一条流水线走完

提交代码

拉取源码

编译构建

构建镜像

启动 / 升级

更新路由

完成

升级拆分次数

灰度发布

回滚

任务模式

用 PasteCluster 让项目快速支持集群

PasteCluster 组件

部署在宿主服务器

任务中转

动态节点

看得见，才敢自动升降

服务器监控

服务监控

数据报表

预警通知

消息推送

日志分级

技术栈矩阵，如实列出

5 分钟装好，然后打开管理端

以容器方式安装 推荐

或者：Linux Systemd 方式

或者：Windows Service 方式

打开管理端

下载 PasteSpider

PasteSpider 能把你的项目
部署成 5 种形态

以容器方式安装推荐