v3.0.1

---

layout: default
title: 发布与打包
description: 了解 NuGet、SDK Bundle、Server Bundle 和安装包的组成与默认启动方式。
permalink: /releases/

SonnetDB 当前的发布物主要分为五类：

类型	产物	说明
NuGet	SonnetDB.*.nupkg	嵌入式核心库、ADO.NET、EF Core Provider、缓存扩展与 CLI 工具包
SDK Bundle	sndb-sdk-<version>-<rid>	面向开发者，包含 NuGet 包、本地 CLI 与配套文档
Server Bundle	sonnetdb-full-<version>-<rid>	面向部署者，包含 SonnetDB、前端、CLI 与默认启动配置
Installer	.msi / .deb / .rpm	面向最终安装的操作系统包
Docker Image	iotsharp/sonnetdb / ghcr.io/<owner>/sonnetdb	面向容器化部署的服务端镜像，包含后台、帮助中心与默认运行配置

默认启动信息

完整服务端发布物通常默认监听：

http://127.0.0.1:5080

常见入口包括：

• /admin/
• /help/
• /healthz
• /metrics

当前发布说明

• [SonnetDB 3.0.0]({{ site.docs_baseurl | default: '/help' }}/releases/3-0-0/)
• [SonnetDB 2.5.0]({{ site.docs_baseurl | default: '/help' }}/releases/2-5-0/)

本地 Windows 打包

在 Windows 开发机上可使用一键脚本同时生成 NuGet 包与 win-x64 ZIP Bundle：

.\eng\build-windows.ps1 -Version <version>

默认最终产物会汇总到 artifacts/windows/final/，并同时生成 Windows MSI（需本机已安装 WiX CLI）。publish/、staging/、nuget/、bundles/、installers/ 等中间目录会在汇总后自动清理。如只验证 .NET 发布链路、不重建管理后台前端，可追加 -SkipAdminUi；如暂不生成 MSI，可追加 -SkipInstaller。

final/ 目录中只保留可发布文件，例如：

• SonnetDB.Core.<version>.nupkg
• SonnetDB.<version>.nupkg
• SonnetDB.EntityFrameworkCore.<version>.nupkg
• SonnetDB.Caching.EasyCaching.<version>.nupkg
• SonnetDB.Caching.Distributed.<version>.nupkg
• SonnetDB.Cli.<version>.nupkg
• sndb-sdk-<version>-win-x64.zip
• sonnetdb-full-<version>-win-x64.zip
• sonnetdb-<version>-win-x64.msi
• 对应 .sha256

MSI 默认安装并启动 SonnetDB Windows 服务，数据目录默认为 C:\ProgramData\SonnetDB\data，并把安装目录加入系统 PATH，让 sndb 可在任意目录使用。安装时可覆盖：

msiexec /i sonnetdb-<version>-win-x64.msi DATAROOT="D:\sonnetdb-data"

推荐阅读顺序

1. [SDK Bundle]({{ site.docs_baseurl | default: '/help' }}/releases/sdk-bundle/)
2. [Server Bundle]({{ site.docs_baseurl | default: '/help' }}/releases/server-bundle/)
3. [安装包]({{ site.docs_baseurl | default: '/help' }}/releases/installers/)
4. [Docker 镜像]({{ site.docs_baseurl | default: '/help' }}/releases/docker-image/)

v2.5.0

Full Changelog: v2.2.0...v2.5.0

v2.2.0

Full Changelog: v2.1.1...v2.2.0

v2.1.1

Full Changelog: v2.1.0...v2.1.1

v2.1.0

Full Changelog: v2.0.0...v2.1.0

v2.0.0

What's Changed

• feat: add InfluxDB-compatible /write and /api/v2/write endpoints by @Copilot in #65
• Bump ModelContextProtocol.AspNetCore from 1.2.0 to 1.3.0 by @dependabot[bot] in #64
• build(deps): bump actions/configure-pages from 5 to 6 by @dependabot[bot] in #60
• build(deps): bump docker/setup-buildx-action from 3 to 4 by @dependabot[bot] in #59
• build(deps): bump actions/upload-pages-artifact from 4 to 5 by @dependabot[bot] in #58
• build(deps): bump actions/setup-node from 5 to 6 by @dependabot[bot] in #57
• build(deps): bump docker/metadata-action from 5 to 6 by @dependabot[bot] in #56
• Bump Microsoft.Extensions.AI from 10.5.1 to 10.5.2 by @dependabot[bot] in #61

Full Changelog: v1.2.0...v2.0.0

v1.2.0

Full Changelog: v1.1.0...v1.2.0

v1.1.0

What's Changed

• fix: AiCopilotBridge.Apply 覆盖配置导致 Copilot 端点全返回 503 by @Copilot in #54
• test: fix flaky stress tests timing out on Windows CI by @Copilot in #55

Full Changelog: v0.2.1...v1.1.0

v0.2.1

Full Changelog: v0.2.0...v0.2.1

v0.2.0

Full Changelog: v0.1.0...v0.2.0