Quaternijkon Homepage

本页是当前服务器的服务入口。站点由 mdBook 生成静态 HTML，经 Nginx Proxy Manager 发布到 www.quaternijkon.online。

常用入口

当前发布方式

• 静态源文件：/root/ai-webapps/homepage-mdbook
• 构建输出：/root/ai-webapps/homepage-static
• HTML 发布目录：/root/ai-webapps/homepage-static/html
• Markdown 输出目录：/root/ai-webapps/homepage-static/markdown，公网路径 /markdown/
• 容器服务：homepage
• 本机后端端口：3003
• 公网入口：https://www.quaternijkon.online/

后续接入认证网关时，建议保持 mdBook 作为静态上游，只在网关层处理登录、会话和访问策略。

AI 服务

说明

本页只记录服务入口，不记录密钥、管理员密码或内部 Token。需要运维凭据时查看本机管理员手册。

基础设施

发布链路

Browser
  -> HAProxy TCP/SNI
  -> Nginx Proxy Manager
  -> homepage container on 3003
  -> nginx static files from /usr/share/nginx/html

3003 属于网页后端端口，公网直连应由 web-entry-firewall 阻断，只允许通过域名入口访问。

认证网关规划

后续加入认证网关时，推荐保持 mdBook 静态站点不处理用户身份，只让网关负责认证和授权。

推荐边界

建议接入方式

1. 保持 mdBook 输出目录和 nginx 静态容器不变。
2. 新增认证网关服务，监听新的本机端口。
3. 将 NPM 的 www.quaternijkon.online 后端从 3003 切到认证网关端口。
4. 认证网关通过内部 HTTP 转发到 homepage:80 或宿主机 3003。

这样 mdBook 内容仍可独立构建和验证，认证逻辑也不会混入静态站点。

mdBook 原生功能

本页用于确认当前 Homepage 只使用 mdBook 原生能力，不依赖第三方插件。

Note

admonition 已由 mdBook 原生 Markdown 支持启用。

Tip

搜索、打印、主题切换、章节折叠、键盘快捷键和 Rust playground 均由 mdBook HTML renderer 提供。

原生配置

HTML renderer

生成可搜索、可打印、可切换主题的静态页面。

Markdown renderer

同步生成经过内置 preprocessors 处理后的 Markdown 输出，便于后续归档或复用。

links preprocessor

处理 include、rustdoc_include 和 playground 等内置模板。

index preprocessor

将章节中的 README.md 作为目录索引页面处理。

包含外部片段

当前发布链路：mdBook source -> static HTML/Markdown output -> nginx container -> Nginx Proxy Manager -> HTTPS domain。

Rust playground

fn main() {
let homepage = "www.quaternijkon.online";
println!("mdBook homepage: {homepage}");
}

fn main() {
let upstream = "127.0.0.1:3003";
println!("homepage upstream: {upstream}");
}

rustdoc_include

fn main() {
    let renderer = "mdBook native renderer";
    println!("{renderer}");
}

数学公式

启用 MathJax 后可以渲染行内公式 \(a^2 + b^2 = c^2\)，也可以渲染块级公式：

\[ E = mc^2 \]

标准 Markdown 扩展

• 任务列表
• 脚注¹
• 定义列表
• admonition

1. 这是 mdBook 原生 Markdown 渲染支持的脚注示例。 ↩

README 索引示例

这个章节文件故意保留为 README.md，用于验证 mdBook 内置 index preprocessor 会把它作为目录索引页处理。