---
name: jjb-static-server-config
description: 定义 JJB 项目静态资源服务器配置规范。在配置 jjb.config.js 的 www、预览构建产物或 CORS 时使用。
---

# 应用配置与开发环境

## 静态资源服务器配置

- **配置来源**：静态资源服务器配置来源于根目录 `jjb.config.js` 文件中的 `www` 属性

- **功能说明**：静态资源服务器用于预览构建后的静态资源文件，基于 Express 搭建，支持 CORS 和单页面应用（SPA）路由

- **配置结构**：

  ```javascript
  // jjb.config.js
  {
    www: {
      // 服务器端口号
      port: 8566,
      // 服务器主机地址
      host: 'localhost',
      // CORS 配置
      cors: '*',
      // 静态资源目录
      static: 'dist'
    }
  }
  ```

- **配置说明**：

  | 配置项 | 类型 | 说明 | 默认值 |
  | :--- | :--- | :--- | :--- |
  | `port` | number | 静态资源服务器监听的端口号 | `8566` |
  | `host` | string | 静态资源服务器绑定的主机地址 | `'localhost'` |
  | `cors` | string | CORS（跨域资源共享）配置，支持通配符 `'*'` 或具体域名 | `'*'` |
  | `static` | string | 静态资源目录路径，相对于项目根目录 | `'dist'` |

- **使用场景**：

  - **预览构建产物**：构建完成后，启动静态资源服务器预览生产环境构建结果

  - **本地测试**：在本地环境中测试构建后的应用，验证构建产物是否正确

  - **跨域测试**：通过配置 CORS 支持跨域访问测试

- **启动命令**：

  ```bash
  # 启动静态资源服务器
  npm run www
  # 或
  yarn www
  ```

- **访问地址**：根据配置的 `host` 和 `port`，默认访问地址为 `http://localhost:8566`

- **注意事项**：

  - 启动静态资源服务器前，需要先执行构建命令生成 `dist` 目录

  - 如果 `static` 配置的目录不存在，服务器会启动但可能无法正常提供服务

  - 静态资源服务器支持单页面应用（SPA）的路由回退，所有路由都会回退到 `index.html`

  - CORS 配置在生产环境中应设置为具体域名，避免使用通配符 `'*'` 带来的安全风险