Skip to content

feat(web): support runtime URL prefixes across updates - #730

Closed
C3nHx wants to merge 1 commit into
zyycn:mainfrom
C3nHx:feat/runtime-web-base-path
Closed

C3nHx wants to merge 1 commit into
zyycn:mainfrom
C3nHx:feat/runtime-web-base-path

Conversation

@C3nHx

@C3nHx C3nHx commented Nov 16, 2026

Copy link
Copy Markdown
Contributor

Why

希望子路径部署直接复用官方发行物,并在在线更新和回退后保留前缀。#724 支持了构建时前缀,但每次升级仍需重建。本 PR 将部署前缀移到运行配置,作为 #723 和 #724 的后续。

Closes #729

问题与改动

  • api.web_base_path 和运行时 CPR_WEB_BASE_PATH 提供经过校验的同源前缀;静态 HTML 在响应中应用 <base>,发行文件字节保持完整
  • 前端使用相对资源,Router 和 API 从同一 document.baseURI 取得前缀;删除构建时前缀配置,文档补充迁移方式
  • 复用现有更新校验与整组回退,反代继续剥除前缀并重写 Cookie、站内 Location;保留前项登录恢复修正

自审与验证

  • Linux Rust 1.99.1 下 Rustfmt、全 workspace 严格 Clippy、670 项 API 测试及 16 项架构测试全部通过;Linux 前端全量格式检查和生产构建通过
  • 真实隔离网关、PostgreSQL 18、Redis 8、Caddy 2.11.9 完成模拟发行包 3.50.0 → 3.50.1 → 3.50.0 的校验下载、安装、自重启和回退;前端只构建一次,逐阶段验证实际版本、登录会话、Cookie Path、页面刷新、PWA 和磁盘 HTML 指纹
  • Windows 已有检查差异已做上游基线对照,详见验收记录。模拟包不是官方发布版本;未调用真实模型,也未修改生产部署,完整容器构建由本 PR 的 CI 核验

职责由 API 静态服务边界持有,更新器不解释部署前缀。输入拒绝跨源、路径穿越和可注入字符。修改不涉及页面设计,默认根路径与多级前缀均以实际浏览器验证。

页面截图

1250×625,浅色主题,测试数据为空。

根路径基线与运行时子路径登录页

基线根路径登录页
运行时子路径登录页

真实 /cprs/accounts 部署的升级前、升级后与回退后

升级前测试版本 3.50.0
升级后测试版本 3.50.1
回退后测试版本 3.50.0

AI 使用

  • Codex,gpt-6.1-sol:方案、实现、文档、最终自审与实际运行验证
  • Codex,gpt-5.6-luna:只读探索、设计候选与独立核验

Co-authored-by: Codex <noreply@openai.com>
@chatgpt-codex-connector

Copy link
Copy Markdown
Codex Review Summary: ❌ Failed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ❌ Failed 2026-11-16T15:51:15.611789Z
We couldn’t complete this review. Comment @codex review to try again.
cf829f6 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Repo admins can enable using credits for code reviews in their settings.

zyycn commented Nov 17, 2026 •

Copy link
Copy Markdown
Owner

感谢这次实现和验证。考虑到项目当前的支持范围,这个 PR 暂不接收,先关闭。

目前子路径部署的边界是构建时配置,由使用者自行构建和升级。本 PR 并没有放开源码构建的在线更新资格,而是希望让官方发行物支持运行时子路径配置,并在更新、回滚后保留前缀。

不过,这属于新增的部署能力:除了前端调整,还引入了后端前缀配置、校验和 HTML 响应改写,并要求后续持续维护该部署模式下的兼容性。现阶段不准备为这项便利扩大后端职责和官方支持范围,继续保留现有的构建时方案。

这次关闭主要是需求范围和长期维护成本的取舍。如果后续决定正式支持官方发行物的运行时子路径部署,再单独讨论需求和实现方案。

@zyycn zyycn closed this Nov 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

支持运行时 URL 前缀并保留官方在线更新能力

2 participants