打包工具

将完整发布目录制作为 Linux 安装包，检查入口、systemd 和安装生命周期。

dotnet-pack 将已经准备好的应用目录制作为 .tar.gz、.deb 或 .rpm，并生成安装所需的元数据与生命周期脚本。它不会替你编译业务插件或自动补齐运行目录。

选择格式

命令	产物	适用交付方式
tar	tar.gz 及安装脚本	显式运行安装/卸载流程
deb	Debian 包	目标系统包管理器
rpm	RPM 包	目标系统包管理器

工具使用 .NET 写入格式，打包期不依赖外部打包命令；验证及安装仍应在适合的目标环境进行。Windows 生成 Linux 包时，还需检查可执行权限的推断结果。

制作一个包

Discussions 通过宿主承载，不单独充当可执行入口。安装 Zongsoft.Tools.Packager 并部署业务插件后，使用 hosting/web/default/pack.cmd 制作 Web 宿主安装包。下面保留该脚本实际命令和变量；format、edition 等值由脚本前面的交互输入决定，应在脚本目录执行完整 pack.cmd，不能把这段片段直接粘贴到 PowerShell。

来源：hosting/web/default/pack.cmd（节选；上下文见源文件）。

pack.cmd

dotnet-pack %format%              ^
	--name:Zongsoft.Hosting.Web   ^
	--title:Zongsoft.Web          ^
	--edition:%edition%           ^
	--version:%version%           ^
	--compilation:%compilation%   ^
	--framework:%framework%       ^
	--platform:%platform%         ^
	--architecture:%architecture% ^
	--Environment:%environment%   ^
	--ASPNETCORE_ENVIRONMENT:%environment% ^
	--daemon:zongsoft.web         ^
	--daemon-bind:8069            ^
	--daemon-environments:Environment,ASPNETCORE_ENVIRONMENT ^
	--postinstalled:"../../.deploy/%scheme%/nginx/reload-nginx.sh" ^
	--postuninstalled:"../../.deploy/%scheme%/nginx/reload-nginx.sh" ^
	--exclude:**/logs/;bin/$(compilation)/$(framework)/*.staticwebassets.* ^
	../../mime                    ^
	appsettings.json              ^
	web*.config                   ^
	web*.option                   ^
	wwwroot                       ^
	plugins                       ^
	bin/$(compilation)/$(framework):~ ^
	"../../.deploy/%scheme%/nginx/zongsoft.web.conf:/etc/nginx/conf.d/zongsoft.web.conf"

这里的 ^ 是 cmd 续行符，%name% 是 cmd 变量，$(name) 则交由打包工具替换。脚本还包含 nginx 安装钩子，应确认目标环境。name 应与实际应用入口相符，而不是仅填写产品展示名。

文件和安装路径

未显式选择打包项时按命令规则收集源目录；可以用文件、目录、末级通配符和 source:target 别名控制内容。--exclude 用于排除日志、缓存和测试配置，不能假定支持 deployer 的全部跨级通配语法。

根路径别名如 /etc/nginx/conf.d/zongsoft.web.conf 表示安装到系统路径。deb/rpm 将它作为对应根路径项处理，tar 放到 .root/ 并由安装脚本复制。应用文件与机器配置的更新、保留和删除策略应分别确认。

systemd 入口

未禁用时，工具会使用指定服务文件或生成服务。--daemon:none、disable、disabled 可禁用服务生成；省略 daemon 并不等于禁用。

--name 参与宿主入口推断，--daemon 可以指定服务标识，--install-path 指定安装目录。Web 宿主应保持入口 Zongsoft.Hosting.Web，服务名可为 zongsoft.web，避免生成启动 Zongsoft.Web.dll 类库的服务。

--daemon-bind:8080 会生成本机 HTTP 地址参数；--daemon-environments 可将选定变量写入服务文件。秘密进入服务文件前需要明确权限和维护方式。

生命周期与验证

安装前后、卸载前后支持扩展脚本。当前生成器区分 Debian 升级动作及 RPM 剩余实例，避免把升级误当最终卸载；旧版已安装包携带的脚本仍可能影响升级，所以还需测试受支持的旧版路径。

InspectPackages.sh

tar -tf application.tar.gz
dpkg-deb --info application.deb
dpkg-deb --contents application.deb
rpm -qip application.rpm
rpm -qlp application.rpm
rpm -qp --scripts application.rpm

以上按实际生成格式选择执行，替换文件名；它们检查产物，不执行安装。重点核对入口文件、安装路径、依赖、权限、配置标记及服务脚本，再在可丢弃目标环境验证首次安装、升级和最终卸载。

🚨 安装包中的脚本会修改系统服务与路径。包能被读取不代表安装、升级和卸载都安全；不要直接用生产应用验证生成规则。

源码入口：打包器、完整选项。