fc-nginx-website

Files (2)

• .bundled-hash
• SKILL.md

SKILL.md (first lines)

# Deploy a static website on function-compute (nginx)
# 在 function-compute 上部署静态网站（nginx）

## AutoClaw managed-delivery boundary (highest priority) / 受控交付边界（最高优先级）

When `website_delivery_start` or `AUTOCLAW_FUNCTION_COMPUTE_WEBSITE_PROTOCOL`
is active, this is an AutoClaw-managed delivery. **Do not call any
`/functionCompute` API, do not read/request/store/output a JWT, and do not run
the curl examples in this Skill.** Treat all API examples as protocol reference
only. Build and verify the project locally, then follow the managed protocol:
for supported nginx preview delivery, update `projects/projects.json` last and
let AutoClaw Main create/upload/publish through its controlled module. A human
owns formal publication.

当 `website_delivery_start` 或 `AUTOCLAW_FUNCTION_COMPUTE_WEBSITE_PROTOCOL`
生效时，本任务属于 AutoClaw 受控交付。**禁止调用任何 `/functionCompute` API，禁止读取、
索取、保存或输出 JWT，也禁止执行本 Skill 中的 curl 示例。** API 内容仅作协议参考。
只在本地完成构建与验证；受支持的 nginx 预览应最后更新 `projects/projects.json`，由
AutoClaw Main 的受控模块完成创建、上传和发布，正式发布始终由用户操作。

## 1. What this environment is / 环境说明

**English.** The `nginx` environment is a **static-file host**. It uses Aliyun
Function Compute's **custom runtime** (`runtime: custom`, Debian 9, ships
**Nginx 1.10.3**). Your uploaded zip is extracted to **`/code`** and served by
Nginx. There is **no application code and no request handler** — Nginx serves
files directly. Do NOT write a Node/Python server here; that is what the
`nodejs`/`python` environments are for.

The platform starts the container with this fixed command:

```
nginx -c /code/nginx.conf
```

So your zip **must** contain an `nginx.conf` at its root, and that config
**must** listen on the platform's port.

Fixed constraints (from the environment preset — do not fight these):

| Property / 属性 | Value / 值 |
|---|---|
| FC runtime | `custom` (Debian 9, Nginx 1.10.3) |
| Start command | `nginx -c /code/nginx.conf` (fixed by the platform) |
| Listen port / 监听端口 | **9000** (nginx must `listen 9000;`) |
| Code root / 代码目录 | **`/code`** (your zip extracts here) |
| Memory / 内存 | 512 MB |
| vCPU | 0.35 |
| Disk / 磁盘 | 512 MB |
| Timeout / 超时 | 60 s |
| Instance concurrency / 实例并发 | 20 |
| Max upload zip / 上传上限 | 50 MB (base64-decoded) |
| Filesystem / 文件系统 | read-only **except `/tmp`** — all Nginx temp/log/pid paths must point at `/tmp` |

**中文.** `nginx` 环境是**静态文件托管**。它使用阿里云函数计算的**自定义运行时**
（`runtime: custom`，Debian 9，内置 **Nginx 1.10.3**）。你上传的 zip 会被解压到
**`/code`** 并由 Nginx 直接提供服务。这里**没有应用代码，也没有请求处理函数**——
Nginx 直接读文件返回。不要在这里写 Node/Python 服务器（那是 `nodejs`/`python` 环境的用途）。

平台用固定命令 `nginx -c /code/nginx.conf` 启动容器，因此你的 zip **必须**在根目录
放一个 `nginx.conf`，且该配置**必须**监听平台端口 **9000**。容器文件系统**只读，
仅 `/tmp` 可写**，所以 Nginx 的 pid / 日志 / 各类 temp 路径都必须落在 `/tmp` 下。

## 2. The file-structure contract / 文件结构约定

Your zip is extracted to `/code`. The **zip root** (not a nested folder) must
contain `nginx.conf` and your static files:

```
mysite.zip
├── nginx.conf        # REQUIRED, at zip root -> /code/nginx.conf
├── index.html
├── styles.css
├── app.js
└── assets/
    └── logo.png
```

Rules / 规则:

- `nginx.conf` **must** be at the root, because the start command reads
  `/code/nginx.conf` literally. 必须放在根目录。
- Do **not** wrap everything in a top-level folder (e.g. `mysite/index.html`) —
  that would extract to `/code/mysite/...` and break `root /code;`. 不要多套一层目录。
- Reference files by paths relative to `/code`. Use `index.html` as the default
  document. 以 `/code` 为根，默认文档为 `index.html`。

## 3. Minimal working example / 最小可用示例

This is a complete, copy-pasteable site. Create these two files.

### `nginx.conf` (copy verbatim / 原样复制)

The `daemon off;`, `user root;`, `listen 9000;`, `root /code;`, and the `/tmp`
temp paths are all **required** for the FC custom runtime. Change the `server`
block body freely, but keep those lines.

```nginx
user root;
worker_processes 1;
daemon off;
pid /tmp/nginx.pid;
error_log /tmp/nginx-error.log warn;
events { worker_connections 1024; }
http {
    include /etc/nginx/mime.types;
    default_type application/octet-stream;
    access_log /tmp/nginx-access.log;
    client_body_temp_path /tmp/nginx-client-body;
    proxy_temp_path /tmp/nginx-proxy;
    fastcgi_temp_path /tmp/nginx-fastcgi;
    uwsgi_temp_path /tmp/nginx-uwsgi;
    scgi_temp_path /tmp/nginx-scgi;
    sendfile on;
    server {
        # FC custom runtime routes traffic to this port. Must be 9000.
        # FC 自定义运行时将流量转发到此端口，必须为 9000。
        listen 9000;
        server_name _;

From Reyvic925/tradingwebsite, MIT.

More from Reyvic925/tradingwebsite