v0.0.1-alpha.2

ICEDR v0.0.1-alpha.2

Important

这是 ICEDR 的第二个预发布版本，适合部署体验、功能验证和早期反馈。预发布阶段仍可能调整接口、配置项和数据结构；升级前请备份数据库、data 目录和对象存储配置。

ICEDR v0.0.1-alpha.2 基于首次预发布继续完善部署体验、发布文档和首次初始化流程。本次发布重点解决二进制运行时数据目录、Docker 镜像命名、GitHub Pages 发布信息读取和对象存储设置引导问题。

本次重点

• 完善 Docker 与二进制部署文档，明确已发布镜像、持久化目录、端口映射、环境变量和升级方式。
• 修复二进制包在 Windows 等环境下错误使用用户目录创建 data 的问题，默认数据目录改为可执行文件所在目录旁的 data。
• 修复二进制包加载 SQLite 原生扩展时缺少模块根目录的问题。
• 保持 Docker Hub 和 GHCR 仓库名一致：corecherry/icedr-po 与 ghcr.io/cloudwhile/icedr-po。
• 优化首次初始化中的对象存储设置：未启用对象存储时不显示 S3 / MinIO 必填项，启用后再展示对应配置。
• 调整文档站最新发布信息的生成方式，避免页面访问时触发 GitHub API 限流。
• 为应用和文档站接入统一 favicon。
• 修复文档站在 Node.js 24 构建环境下的依赖兼容问题。

使用者可见变化

部署文档

• 新增 Docker 部署文档，推荐使用 docker run -d 直接启动已发布镜像。
• 新增二进制部署文档，说明平台文件选择、启动方式、长期运行、数据目录和校验方式。
• 扩充配置说明，覆盖数据库、Redis、文件存储、外链公开地址、SMTP、OIDC、更新检查和生产环境校验。
• 发布说明页会展示最新 Release 信息、发布文件、日期、Docker 标签和校验方式。

首次初始化

• 对象存储改为显式启用后再填写配置项。
• 未配置对象存储时，系统继续使用本地文件存储。
• 初始化流程保留 SQLite 优先体验，适合单机或试用部署；需要 PostgreSQL 时可在数据库步骤配置。

二进制运行

• 二进制文件默认在自身所在目录旁创建 data。
• SQLite 数据库、本地文件、原生扩展缓存和数据库来源记录都会保存在该目录中。
• 可继续通过 ICEDR_DATA_DIR 指定自定义数据目录。

Docker 发布

• Docker Hub：corecherry/icedr-po
• GitHub Container Registry：ghcr.io/cloudwhile/icedr-po
• 当前版本为预发布版本，因此不会更新 latest 标签。

docker pull corecherry/icedr-po:0.0.1-alpha.2
docker pull ghcr.io/cloudwhile/icedr-po:0.0.1-alpha.2

升级提示

• 从 v0.0.1-alpha.1 升级前，请备份 SQLite 数据库、data/local-files 和对象存储配置。
• 使用 Docker 部署时，继续挂载原来的宿主机数据目录或 volume。
• 使用二进制部署时，建议将新二进制文件放到原目录，继续使用原来的 data。
• 如果曾经因为旧二进制在用户目录下创建了 data，请先确认真实数据所在位置，再迁移到新的程序目录旁。
• 如果启用了对象存储，请确认 S3 / MinIO endpoint、bucket、access key、secret key 和 path-style 选项仍然正确。

文件完整性

Release 会自动附加发布文件列表、文件大小、MD5、SHA256 和 release-manifest.json。下载后可使用下列命令校验：

md5sum -c MD5SUMS.txt
sha256sum -c SHA256SUMS.txt

Windows PowerShell 示例：

Get-FileHash .\icedr_VERSION_windows-x86_64.exe -Algorithm SHA256

Full Changelog

v0.0.1-alpha.1...v0.0.1-alpha.2

Release Assets

File	Size	MD5	SHA256
icedr_0.0.1-alpha.2_linux-arm64	137.0 MB	59cc5eea3593050cf829719090f2e36f	c7e07552ea905517c0cf15aedfae31cec84d1b244b979888f3833c5ffb044f97
icedr_0.0.1-alpha.2_linux-x86_64	139.1 MB	a1b62403884b62c2ece5e3470b9bc239	69a3aa4e3cc12f62af8b84635bd37d62c8b8c0cc0bd2788c9be4d68711717932
icedr_0.0.1-alpha.2_macos-arm64	136.1 MB	8f2bc3f11eaf54eb78fd86a3bfafe3ce	159db452dc63a2ab7c250e379e03b558c3e56a7881d19f3032ee0dd33156b9f6
icedr_0.0.1-alpha.2_macos-x86_64	138.3 MB	8c69708a382e9a781a25006fb9e994b0	fb07e18fe0c5d1ea50e0e343347edbe88b1baf7deac12547747b74554da4cc62
icedr_0.0.1-alpha.2_windows-arm64.exe	98.8 MB	3020ed1ce6370d366057007ca991a064	e1e3bddad2d34ff580c158cdd89b141b3a3f4befb1c433803840e31841d313b0
icedr_0.0.1-alpha.2_windows-x86_64.exe	109.7 MB	a8c8894c1322ffdc209492f2ce9cee8b	eccfafb75eec0253e65b3028931f60fc1239b34bcb839b65672afe2699db96cb
MD5SUMS.txt	411 B	325c525a32fd977c3678d00fc73015cb	1b3d684ab0f8191e8d79c9a9e7c2d9ca8255b636c4290a403a7b2596515f1433
SHA256SUMS.txt	603 B	a13cc479e4892eaaadff4aba963b5c81	25c6bf33168167fad2b492611ef8ae15f9e897d81debffbe25649761dd7937eb
release-manifest.json	1.8 KB	3ef738b8771289ff5e396e3d2196cbe4	08de39a1bdfd82cd07bed7eb884924abc4975d1cb9b370227e6bb964694badbb

File Checksums

MD5

59cc5eea3593050cf829719090f2e36f  icedr_0.0.1-alpha.2_linux-arm64
a1b62403884b62c2ece5e3470b9bc239  icedr_0.0.1-alpha.2_linux-x86_64
8f2bc3f11eaf54eb78fd86a3bfafe3ce  icedr_0.0.1-alpha.2_macos-arm64
8c69708a382e9a781a25006fb9e994b0  icedr_0.0.1-alpha.2_macos-x86_64
3020ed1ce6370d366057007ca991a064  icedr_0.0.1-alpha.2_windows-arm64.exe
a8c8894c1322ffdc209492f2ce9cee8b  icedr_0.0.1-alpha.2_windows-x86_64.exe

SHA256

c7e07552ea905517c0cf15aedfae31cec84d1b244b979888f3833c5ffb044f97  icedr_0.0.1-alpha.2_linux-arm64
69a3aa4e3cc12f62af8b84635bd37d62c8b8c0cc0bd2788c9be4d68711717932  icedr_0.0.1-alpha.2_linux-x86_64
159db452dc63a2ab7c250e379e03b558c3e56a7881d19f3032ee0dd33156b9f6  icedr_0.0.1-alpha.2_macos-arm64
fb07e18fe0c5d1ea50e0e343347edbe88b1baf7deac12547747b74554da4cc62  icedr_0.0.1-alpha.2_macos-x86_64
e1e3bddad2d34ff580c158cdd89b141b3a3f4befb1c433803840e31841d313b0  icedr_0.0.1-alpha.2_windows-arm64.exe
eccfafb75eec0253e65b3028931f60fc1239b34bcb839b65672afe2699db96cb  icedr_0.0.1-alpha.2_windows-x86_64.exe