> For the complete documentation index, see [llms.txt](https://docs.zongsoft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zongsoft.com/hosting/deployment.md).

# 部署宿主

将宿主、插件与环境配置组合成可运行目录，核对变量、版本和更新边界。

宿主部署包含宿主发布产物、插件程序集及清单、配置、映射和其他资源。`dotnet publish` 主要准备宿主运行产物，`dotnet deploy` 按部署清单组合插件；二者输出应汇合到同一个受控运行目录。

## 先确认方案与变量

hosting 的部署脚本组合宿主 `.deploy` 与 `.deploy/{scheme}` 下的公共方案文件。

| 变量                      | 意义                                | 容易混淆之处                     |
| ----------------------- | --------------------------------- | -------------------------- |
| `scheme`                | 部署方案                              | 不是运行环境                     |
| `environment`           | development/test/production 等配置环境 | 不等于 Debug/Release          |
| `edition`               | 此部署工具调用中的编译输出配置                   | 升级工具中的同名选项表示版本分发名          |
| `framework`             | 目标框架，例如 net10.0                   | 需与已有编译输出匹配                 |
| `platform/architecture` | 原生资源及运行时选择                        | 不是当前执行脚本机器的必然值             |
| `host/site`             | 宿主与站点的组合选择                        | 终端使用 terminal/daemon 是有意安排 |
| `debug`                 | 方案中定义的调试开关                        | 可能选择附加配置，不只是生成 PDB         |

变量由脚本、命令行及部署定义共同使用，详见[部署文件格式](/references/deploy-files.md)。复制命令前应确认目标目录，避免误覆盖另一个宿主。

## 配置应该放在哪里

应用通用设置进入宿主应用选项，插件专属设置可用与清单文件基名匹配的 `.option`。环境变体如 `Zongsoft.Security.development.option`，附加调试变体如 `Zongsoft.Security.development-debug.option`。

具体匹配和优先级见[选项文件](/references/option-files.md)。同一配置键尽量由明确的一处最终配置负责，避免依赖不同插件之间未承诺的覆盖顺序。

## 部署后的检查

1. 核对宿主入口、运行时配置和最终程序集版本。
2. 核对 Main、宿主变体及业务清单，检查依赖名称与目标扫描目录。
3. 核对 `.mapping`、SQL、标准库、原生库、模板等附属资源。
4. 检查配置选中了预期环境、端点和站点。
5. 启动后执行一次业务操作，确认延迟连接和服务调用正常。

首次学习建议采用[最小部署教程](/get-started/deploy-first-plugin.md)，现有业务方案则按仓库脚本的真实参数执行。

## 局部更新

开发时可以停止宿主后只复制变化的 DLL、PDB 和有关资源，但前提是确认依赖兼容。只替换 DLL 而遗漏新清单、映射或依赖，会造成“编译成功、运行失败”。

手工复制没有自动撤销旧文件的语义。删除旧插件或拆分程序集时，应明确清理哪些旧产物，并核对其是否仍被其他插件使用。正式交付更适合由可重复的部署清单生成完整目录。

## 数据与升级边界

环境秘密、持久数据和可替换程序文件应有明确所有权。完整程序目录不一定适合原样打包：运行日志、缓存数据库及临时文件可能被锁定或包含环境数据。

使用[自动升级](/framework/upgrading.md)时，额外核对 `.deployer`、升级器插件、实际应用名和持久数据位置。重新执行部署脚本后，再确认手工补充的运行产物是否仍在目录中。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.zongsoft.com/hosting/deployment.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.