xyc
1 天以前 079d872fabfe488abf485d8898c40ff1fd746472
docs/´ò°ü²¿Êð˵Ã÷.md
@@ -66,7 +66,7 @@
│  â”œâ”€ æŠ•资\
│  â”‚  â””─ æ¨¡æ¿\
│  â””─ (6月\ 7月\ ç­‰å¯¼å…¥æ•°æ®ç›®å½•,按需)
└─ web\                       # å‰ç«¯ dist çš„内容
└─ web\                       # å‰ç«¯ dist çš„内容(由后端 8090 æ‰˜ç®¡ï¼‰
   â”œâ”€ index.html
   â”œâ”€ css\  js\  fonts\
```
@@ -75,7 +75,8 @@
- **`docs` å¿…须放在 jar åŒçº§**。后端运行时按启动目录向上查找 `docs`(报表导出的 Word æ¨¡æ¿ã€å¯¼å…¥é¡µã€Œä¸‹è½½æ¨¡æ¿ã€ã€ç›®å½•导入数据都从这里读),找不到会报「未找到数据目录 docs」或「未找到模板文件 xxx」。
- é¦–次部署直接把项目里的整个 `docs` æ‹·è¿‡åŽ»æœ€ç¨³å¦¥ï¼›åŽç»­å¯ç²¾ç®€ï¼ˆåªç•™æ¨¡æ¿å­ç›®å½•ï¼‰ï¼Œè¯¦è§ã€Œå¸¸è§é—®é¢˜ã€ã€‚
- `application.yml` æ‰“包在 jar å†…;部署机需要改配置时,可在 jar åŒçº§æ”¾ä¸€ä¸ªå¤–ç½® `application.yml`(外置优先级高于内置),或改完再打包。
- `application.yml` æ‰“包在 jar å†…,已内置前端静态托管(`file:./web/`);部署机需要改配置时,可在 jar åŒçº§æ”¾ä¸€ä¸ªå¤–ç½® `application.yml`(外置优先级高于内置,注意需包含完整配置),或改完再打包。
- å¯åŠ¨åŽæµè§ˆå™¨ç›´æŽ¥è®¿é—® `http://<服务器>:8090`,无需额外 Web æœåŠ¡å™¨ã€‚
## å…­ã€å…³é”®é…ç½®ï¼ˆapplication.yml)
@@ -103,9 +104,13 @@
- æˆåŠŸæ ‡å¿—ï¼šæ—¥å¿—å‡ºçŽ° `Started TrafficAuditApplication` å’Œ `Tomcat started on port(s): 8090`。
- åœ¨ `deploy` ç›®å½•下启动即可命中同级的 `docs`。
## å…«ã€å‰ç«¯éƒ¨ç½²ï¼ˆnginx ç¤ºä¾‹ï¼‰
## å…«ã€å‰ç«¯éƒ¨ç½²ï¼ˆæŽ¨èï¼šSpring Boot ç›´æŽ¥æ‰˜ç®¡ï¼Œæ— éœ€ IIS/nginx)
`dist` æ˜¯çº¯é™æ€æ–‡ä»¶ï¼Œéœ€è¦ Web æœåŠ¡å™¨æ‰˜ç®¡ï¼›å‰ç«¯æŽ¥å£èµ°ç›¸å¯¹è·¯å¾„ `/api`,**必须反代到后端 8090**:
- æŠŠå‰ç«¯æž„建产物 `dist` çš„内容放到 jar åŒçº§ç›®å½• `web\`(即 `web\index.html`、`web\js\`、`web\css\`、`web\fonts\`)。
- åŽç«¯å·²å†…置:`spring.web.resources.static-locations: file:./web/`(静态托管)+ å®‰å…¨é…ç½®æ”¾è¡Œé™æ€èµ„源,启动后直接访问 `http://<服务器>:8090` å³å¯ï¼Œé¡µé¢ä¸Ž `/api` åŒæºï¼Œ**不需要 IIS/nginx åä»£**。
- å‰ç«¯è·¯ç”±ä¸º hash æ¨¡å¼ï¼Œåˆ·æ–°/直达无 404 é—®é¢˜ã€‚
### å¤‡é€‰ï¼šnginx æ‰˜ç®¡ + /api åä»£ï¼ˆå¦‚需前后端分离)
```nginx
server {
@@ -115,7 +120,7 @@
    index index.html;
    location / {
        try_files $uri $uri/ /index.html;   # è·¯ç”±ä¸º hash æ¨¡å¼ï¼Œæ­¤è¡Œä¿ç•™ä»¥é˜²åŽç»­æ”¹ history
        try_files $uri $uri/ /index.html;
    }
    location /api {
@@ -129,9 +134,11 @@
}
```
> è‹¥å‰ç«¯ç”± IIS æ‰˜ç®¡ï¼Œéœ€å®‰è£… URL Rewrite 2.0 + ARR 3.0 å¹¶å¯ç”¨ proxy,站点根目录放 `docs/iis-web.config.example`(重命名 web.config),规则示例见该文件。
## ä¹ã€éƒ¨ç½²åŽéªŒè¯
1. æµè§ˆå™¨æ‰“å¼€ `http://<服务器>/`;
1. æµè§ˆå™¨æ‰“å¼€ `http://<服务器>:8090`;
2. ç”¨ `admin / admin123` ç™»å½•(生产改密后使用新密码);
3. æ•°æ®å¯¼å…¥ï¼šä¸‹è½½æ¨¡æ¿ â†’ ä¸Šä¼  Excel(或目录导入);
4. æŠ¥è¡¨ï¼šæŸ¥è¯¢ â†’ é¢„览/导出(依赖 `docs` æ¨¡æ¿æ–‡ä»¶ï¼‰ï¼›
@@ -143,7 +150,7 @@
|------|------------|
| å¯åŠ¨æŠ¥ã€Œæœªæ‰¾åˆ°æ•°æ®ç›®å½• docs」 | å½“前运行目录不对;把 `docs` æ”¾åˆ° jar åŒçº§å†å¯åЍ |
| å¯¼å‡ºæŠ¥ã€Œæœªæ‰¾åˆ°æ¨¡æ¿æ–‡ä»¶ xxx」 | `docs` å¯¹åº”子目录缺模板文件;首次部署拷整个 `docs` |
| é¡µé¢èƒ½å¼€ä½†æŽ¥å£ 502/404 | nginx æ²¡é… `/api` åä»£ï¼Œæˆ–后端没启动成功 |
| é¡µé¢èƒ½å¼€ä½†æŽ¥å£ 404(验证码加载失败) | å‰ç«¯ç”± IIS/nginx æ‰˜ç®¡æ—¶æ²¡é… `/api` åä»£ï¼›æ”¹ç”¨ Spring Boot æ‰˜ç®¡ï¼ˆweb\ ç›®å½•)则无此问题 |
| æ•°æ®åº“连接失败 | æ£€æŸ¥ `application.yml` åœ°å€/账号/密码;先执行 `init.sql` |
| ä¸Šä¼ å¤§æ–‡ä»¶å¤±è´¥ | æ£€æŸ¥ nginx `client_max_body_size` ä¸ŽåŽç«¯ multipart é™åˆ¶ |
| ç«¯å£å ç”¨ | åŽç«¯ 8090、前端 80/8080 |