文档/安全与部署

部署

两个命令：nx build 生成工件，nx start 为它们提供服务。

开始之前： 使用 nx build 在本地构建的项目，以及 - 对于客户端页面 - nx new 安装的前端工具链。

nx buildnx start --host 0.0.0.0 --port 8000

运行时仅需要 Python。 Uvicorn 提供编译后的应用程序和静态资源；不涉及 Node 进程和 Vite 进程。

构建产生什么

__nexy__/ 包含已编译的路由模块、__nexy__/client/ 下的客户端包以及框架路由的预渲染 HTML。复制项目 - 源加上 __nexy__/ - 或在图像内构建。

Docker

构建阶段需要 Node（对于 Vite）和 Python（对于编译器）。运行时阶段仅需要 Python。

FROM node:22-bookworm-slim AS buildWORKDIR /app COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uvCOPY pyproject.toml uv.lock ./RUN uv sync --frozen --no-install-project COPY . .RUN uv sync --frozen && uv run nx build FROM python:3.13-slimWORKDIR /appCOPY --from=build /app /appENV PATH="/app/.venv/bin:$PATH" EXPOSE 8000CMD ["nx", "start", "--host", "0.0.0.0", "--port", "8000"]

当基础镜像没有时，uv 会获取托管的 Python，这就是构建阶段可以从 Node 镜像开始的原因。

在反向代理后面

在本地主机上运行 nx start 并让 Nginx、Caddy 或平台代理终止 TLS：

nx start --host 127.0.0.1 --port 8000

如果您使用 SOCKET 处理程序，请确保代理转发 WebSocket 升级，并且它转发原始主机 - FastAPI 从中构建绝对 URL。

健康检查

async def GET():    return {"status": "ok"}

from nexy.decorators import Controller  @Controller("/health")class HealthController:    async def get(self):        return {"status": "ok"}

内置端点

负载均衡器或 Kubernetes 会问两个问题：进程是否处于活动状态，是否可以接收流量？设置 useHealth，Nexy 都会回答这两个问题，没有处理程序文件，也没有控制器：

from nexy.core.models import NexyConfigModel  class NexyConfig(NexyConfigModel):    useHealth = True

Nexy 保证 /health/ready 跟随服务器的启动和关闭。

Nexy 保证两个端点都不在访问日志和 OpenAPI 模式之外。

Nexy 保证两个端点在 useTrustedHost 和 useHTTPSRedirect 之前应答，因此通过 HTTP 发送到 pod 地址的探测不会被拒绝。

按照惯例，当 useHealth 打开时，您将自己的路由保持在 /health/live 和 /health/ready 关闭状态：Nexy 的端点首先应答。默认情况下，useHealth 为 False，因此未设置它的项目将保留这两个路径。

您的应用程序负责检查它所依赖的内容：/health/ready 报告服务器的生命周期，而不是数据库的状态。

将 Kubernetes Deployment 的探针指向它们：

apiVersion: apps/v1kind: Deploymentmetadata:  name: appspec:  replicas: 2  selector:    matchLabels:      app: app  template:    metadata:      labels:        app: app    spec:      containers:        - name: app          image: registry.example.com/app:1.0          ports:            - containerPort: 8000          livenessProbe:            httpGet:              path: /health/live              port: 8000            periodSeconds: 10          readinessProbe:            httpGet:              path: /health/ready              port: 8000            periodSeconds: 5

静态托管

每个页面都是 HTML，但 Nexy 假定有一个用于路由和 API 处理程序的服务器。

清单

• nx build 在 CI 中，对于您希望在服务器上呈现的路由没有警告
• 当路由文件无法加载时，[ ] nx start 退出并显示代码 1，并且不启动任何内容
• NEXY_ACTION_SECRET 设置，或 __nexy__/action.key 与构建一起保留
• useDocs = False 在生产中如果 API 架构不应公开
• useTrustedHost 和 useHTTPSRedirect 设置为公共部署
• useHealth = True 当负载均衡器或 Kubernetes 探测应用程序时
• __nexy__/ 未提交

后续步骤

• 配置：HTTPS、可信主机、会话
• 前端：Vite 构建什么
• 测试：在 CI 中运行的命令

以 Markdown 复制本页 在 GitHub 上编辑