m1saka/dsh-web
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
65d118a1454e83c3c3b8563258b6b8eecd849a35
dsh-web/README.md
T

8.9 KiB
Raw Blame History

DSH Runtime Release

runtime-7.5：精简 MiSans 字重

本次待发布修订为 runtime-7.5，仅保留 MiSans Regular 和 Bold，从第三方 GitHub 仓库 boyan01/mi_sans_font 的固定提交下载独立 TTF 并逐个校验 SHA-256，合计约 15.73 MB，不再下载官方完整 ZIP。构建环境需要能够访问 raw.githubusercontent.com。

runtime-7.4：文档工具、中文字体与 Chat Manager 修复

runtime-7.4 修订内容：新增 Python、LibreOffice、Noto CJK 与 MiSans，并内置修复版 Chat Manager。DSH 版本仍为 0.2.0-rc.2，运行布局仍为 7，继续保留 runtime-7.3 的域名设置适配。已完成本地 AMD64 构建、19 项测试、离线启动及插件接口认证拒绝检查；ARM64 与线上面板完整删除流程尚未验收。

内置修复版 Chat Manager

镜像内置 [email protected]（基于官方 1.5.12，保留 MIT 许可及服务端安全校验）。补丁仅针对客户端：删除、恢复、归档搜索在面板内使用当前 /dsh/<实例ID>/ 前缀，独立 DSH 根路径部署保持原行为；非 JSON 响应显示 HTTP 状态和代理排查提示，不再直接暴露 JSON 解析异常。不会修改全局 fetch、绕过 Cookie/Origin/可信主机校验或自动重试删除请求。

新建空 web profile 默认启用此插件，内置包和 clsx 依赖均支持离线安装。已有 profile 不会被覆盖，也不会自动替换用户已安装的官方版本。升级镜像后，如需迁移已有实例，请保留其他设置，将 profile 中同名依赖改为 file:/usr/local/lib/dsh-mgr/dsh-chat-manager-1.5.12-dsh-mgr.1.tgz，并设置 pnpm override dsh-chat-manager>clsx 为 file:/usr/local/lib/dsh-mgr/clsx-2.1.1.tgz，确保 bundles 中只有一次 dsh-chat-manager，再重启实例。不要同时启用重复的手动 patch 插件条目。

域名访问仍要求 DSH 配置相应 trusted host，且 runtime 必须经过面板认证与实例归属校验。此修复不开放面板根路径的插件接口。

内置 Python 与 LibreOffice

Runtime 镜像包含 Debian Bookworm 的 Python 3、pip、venv（python 指向 python3），以及 LibreOffice 和 Noto CJK 中文字体。LibreOffice 可通过 libreoffice --headless 无界面运行。Python 项目依赖请安装到工作区的虚拟环境中，不要覆盖系统 Python 包。

这些依赖在镜像构建时安装；已有实例需要重建镜像并升级后才生效。

另包含小米 MiSans 简体中文字体的 Regular 和 Bold 两个静态 TTF 字重，保留 Noto CJK，不修改默认字体优先级。构建时从第三方镜像 boyan01/mi_sans_font 的固定提交 68f3ec3fee5830ce8a1d955d462fa0df401a5341 下载两个 TTF 并校验各自 SHA-256；镜像文件与当前官网 ZIP 不同，不保证为最新版本，GitHub 仓库许可不替代小米字体许可。字体及声明位于 /usr/local/share/fonts/misans。MiSans 使用小米专有免费商用许可，并非开源字体许可；安装使用及对外分发镜像前应阅读官方许可协议，不得单独分发或售卖字体。

runtime-7.3：域名访问设置适配

自 runtime-7.3 起，构建时对 DSH 0.2.0-rc.2 的设置 UI 应用精确补丁，使设置视图与表单使用 host 持久化；不修改 connection.isLoopback、可信主机、Origin 或认证逻辑。版本或目标语句不匹配时构建失败，升级上游版本必须重新审核补丁。

这是构建期适配，不是普通插件。补丁本身不识别面板登录状态，该镜像的设置 UI 会对所有访问地址尝试远程设置操作，因此只能部署在受认证、校验实例归属的面板入口之后，不得绕过认证直接公开 runtime 端口。权限由服务端保证。

发布前须在非 localhost 域名验证提供商目录、配置与凭据保存、刷新和重启持久化，以及未登录、跨用户和非法 Origin 的拒绝行为。单元测试不代替这些验收；现有实例需升级镜像才生效，不覆盖用户 profile 或创建空 patch。

dockerfile 分支只维护发布清单和 runtime 镜像构建文件，不包含管理面板源码或部署配置。

发布清单

release.json 是发布入口：schema_version 为清单格式版本，release_id 标识一次发布，version 为精确 DSH 版本，deployment_schema 为运行布局版本，platforms 为支持的平台。当前待发布配置为 runtime-7.5、DSH 0.2.0-rc.2、布局 7、linux/amd64 和 linux/arm64（aarch64，不含 32 位 ARM）。

ARM64 验收状态：已确认 Node/Caddy 基础镜像提供 ARM64 版本，但尚未完成 ARM64 runtime 构建及运行验收。清单声明会开放面板的对应平台构建入口，不等于兼容性证明；验收完成前不要推送发布。

此分支是可信代码来源，不是仅供读取的数据源：Dockerfile 和安装脚本会在构建时执行。只使用经过审核的提交，不要将不可信分支、PR 或任意远端内容直接用于构建。清单本身不代表镜像已经完成运行验收。

本地构建与检查

需要 Docker、Node.js，以及拉取基础镜像和构建依赖的网络。从仓库根目录执行，DSH 版本取自清单，平台按 Docker daemon 架构选择，不跟踪 latest：

set -eu
DSH_VERSION="$(node -p "require('./release.json').version")"
case "$(docker info --format '{{.Architecture}}')" in
  aarch64|arm64) PLATFORM=linux/arm64 ;;
  x86_64|amd64) PLATFORM=linux/amd64 ;;
  *) echo 'Unsupported Docker daemon architecture' >&2; exit 1 ;;
esac
RELEASE_ID="$(node -p "require('./release.json').release_id")"
node --test image/*.test.mjs
docker build --platform "$PLATFORM" \
  --build-arg DSH_VERSION="$DSH_VERSION" \
  -t "dsh-web:$RELEASE_ID-${PLATFORM#linux/}" ./image

默认按 Docker daemon 架构原生构建，不再固定取清单第一个平台。在交叉构建环境可手动将 PLATFORM 设置为 linux/arm64 或 linux/amd64；需要事先配置对应原生 builder 或 QEMU/binfmt，仅设置 --platform 不会自动提供模拟能力。

Dockerfile 两个阶段均继承目标平台，无需写死架构；不要将 Caddy 阶段固定为构建主机平台，也不要复用另一架构的 node_modules。

发布前分别验证两个架构的镜像构建、非 root 启动、代理认证、终端及原生模块、内置插件离线协调、工作区写入和重启持久化，以及升级/恢复路径。迁移工作区时需重新安装其中的架构相关依赖。

image/ 是构建上下文。构建只生成本地镜像，不推送镜像，也不自动发布分支。保留 image/init-profile.test.mjs 作为独立 runtime 回归测试，覆盖初始化幂等性、保留已有配置和拒绝符号链接目录；它不依赖面板，且被 image/.dockerignore 排除在构建上下文之外。此测试不能替代真实容器启动、插件和持久化验收。

布局 7 合约

  • 以 UID/GID 1000 运行；实例持久目录挂载到 /workspace，必须允许该身份读写。DSH_HOME、HOME 和工作目录均为 /workspace，XDG 数据与配置也位于其中。
  • /data/dsh-home 是指向 /workspace 的兼容符号链接；不要用旧 home 挂载覆盖该路径。/shared 不是布局 7 的持久化入口。
  • DSH 监听 loopback 3080，Caddy 在容器 8080 转发；只通过受信入口访问，不直接公开 runtime 端口，不挂载 Docker socket。原生模块需要可执行的 /tmp，可保留 nosuid/nodev 与容量限制。
  • 新 profile 默认启用固定版本的 mobile、free-search 和 workspace bundle，默认工作区为 /workspace。已有非空 profile 不自动注入或覆盖；升级镜像不会强制改变已有插件选择。
  • 启动前协调插件依赖，失败则不启动应用；仅含内置固定依赖的 profile 使用离线安装。用户添加插件后可能需要网络。

手动发布

  1. 审核 runtime 资产变更及其可信来源，选择精确 DSH 版本，更新 release.json。每次发布变更都必须使用新的 release_id；布局合约变化时同步更新 deployment_schema、镜像及调用方适配，不能只修改数字。
  2. 运行上述测试与本地构建，并完成目标平台的容器启动、插件、持久化与兼容验收；检查 git diff --check 和最终差异。
  3. 维护者确认后，手动提交并手动推送 dockerfile 分支到已核实的发布远端。修改清单或本地构建不会自动 commit/push，也不会自动更新运行中的实例。

文件范围

  • release.json：发布清单。
  • README.md：本分支说明。
  • image/Dockerfile、image/Caddyfile、image/entrypoint.sh、image/.dockerignore：镜像构建与启动。
  • image/install-*.mjs、image/init-profile.mjs：内置 runtime 资产安装与 profile 初始化。
  • image/init-profile.test.mjs：保留的 profile 初始化回归测试。
  • image/entrypoint.test.mjs：从面板测试迁移的 runtime 启动失败保护与镜像约束测试，需要 Bash；不依赖 Go 或面板。
Reference in New Issue View Git Blame Copy Permalink