docs: 更新部署文档

packages/docs/src/notes/guide/quick-start/部署.md

@@ -1,26 +1,26 @@
 ---
-title: 部署(待更新)
+title: 部署
 createTime: 2025/03/29 23:50:17
 permalink: /guide/n6o11owv/
 ---
 
-> **此文档尚未更新，请勿参考。**
-
 > 本文档适用于部署 Astral3D 编辑器到服务器上。 <br />
-> 以[Golang版本](https://github.com/mlt131220/Astral3DEditorGoBack)后端为例，其他语言版本后端部署方式请参考官方文档。
+> 以[Java版本](https://github.com/yx8663/astral-service)后端为例，其他语言版本后端部署方式请参考官方文档。
 
 ## 本地打包
 
 ### 前端打包
 ```bash
-# 确认 Node.js 版本（≥ 23.x）
+# 确认 Node.js 版本（≥ 23.11.x）
 node -v
 
 # 拉取代码
 git clone https://github.com/mlt131220/Astral3D.git
 
-# 安装依赖
+# 进入项目
 cd Astral3D
+
+# 安装依赖
 pnpm install
 
 # 打包 Astral 3D Engine SDK
@@ -32,32 +32,33 @@ pnpm run editor:build
 
 ### 后端打包
 ```bash
-# 确认go环境
+# 确认java环境
-go version
+java -version
+
+# 确认maven环境
+mvn -v
 
 # 拉取代码
-git clone https://github.com/mlt131220/Astral3DEditorGoBack.git
+git clone https://github.com/yx8663/astral-service
 
 # 安装依赖
-go mod tidy
+mvn clean install
 
-# 修改数据库等配置（修改 conf/app.conf，详见 https://github.com/mlt131220/Astral3DEditorGoBack/blob/main/README.md）
+# 修改数据库等配置（修改 astral-web/src/main/resources/application-dev.yml，详见 https://github.com/yx8663/astral-service/blob/develop/README.md#%E9%85%8D%E7%BD%AE）
-edit conf/app.conf
+vim astral-web/src/main/resources/application-dev.yml
 
-# 安装bee工具
+# 编译打包（通过maven打包即可跨平台）
-go get -u github.com/beego/bee/v2
+# 生产环境推荐用clean package跳过测试
+mvn clean package -DskipTests
 
-# 编译后端代码
+# jar包： astral-web/target/astral-web.jar
-# Linux
+ls -l astral-web/target/*.jar
-bee pack -be GOOS=linux -be GOARCH=amd64
-# Windows
-bee pack -be GOOS=windows
 ```
 
 ## 服务器部署(Windows)
 
 ### 基础环境
-- [Nginx](https://nginx.org/en/download.html)
+- [Nginx](https://nginx.org/en/download.html)/[caddy](https://caddyserver.com/)
 - [MySQL](https://www.mysql.com/cn/downloads/)
 
 或者直接使用集成环境，如[PHPStudy](https://old.xp.cn/download.html)。
@@ -66,10 +67,23 @@ bee pack -be GOOS=windows
 将Astral 3D Editor打包后的文件放到方便读取的目录下，如 `C:\www\Astral3dEditor`;
 
 ### 后端部署
-1. 将后端编译后的文件放到方便读取的目录下，如 `C:\www\Astral3DEditorGoBack`;
+1. 将后端部署所需文件/文件夹放到方便读取的目录下，如 `C:\www\Astral3DEditorBack`,所需文件/文件夹如下：
-2. 打开 MySQL 数据库，创建名为 `astral3d` 的数据库，并导入 `Astral3DEditorGoBack/static/sql/astral-3d-editor.sql` 文件；
+   * `static` 文件夹；
-3. 启动 MySQL 服务，并确保 MySQL 服务正常运行；
+   * `astral-web/target/astral-web.jar`；
-4. 双击后端程序打包生成的可执行文件 `Astral3DEditorGoBack.exe` 启动后端服务，默认监听 `8080` 端口；
+   * `astral-web/src/main/resources/application.yml`
+   * `astral-web/src/main/resources/application-dev.yml`
+2. 此时`C:\www\Astral3DEditorBack`内容如下：  
+
+   ``` shell
+    - static/
+    - application.yml
+    - application-dev.yml
+    - astral-web.jar
+   ```
+
+3. 打开 MySQL 数据库，创建配置在 `application-dev.yml` 的数据库，并导入 `static/sql/astral_3d.sql` 文件；
+4. 启动 MySQL 服务，并确保 MySQL 服务正常运行；
+5. 在 `C:\www\Astral3DEditorBack` 下运行命令 `java -jar astral-web.jar` 启动后端服务，默认监听 `8080` 端口；
 
 ### Nginx 配置
 1. 打开 Nginx 配置文件，假设nginx安装目录为`C:\nginx`,则配置文件路径为`C:\nginx\conf\nginx.conf`;
@@ -102,6 +116,11 @@ bee pack -be GOOS=windows
             try_files $uri $uri/ index.html;
             # 项目入口文件
             index  index.html;
+   
+            # 协商缓存配置，30天
+            add_header Cache-Control "public, max-age=2592000";
+            expires 30d;
+            etag on;
         }
 
         # 后端api接口代理，接口请求匹配 /api 的会走此处转发，下面都同理
@@ -122,20 +141,14 @@ bee pack -be GOOS=windows
             proxy_send_timeout  300s;
         }
 
-        # 如果需要使用upyun上传功能，则需要添加以下配置
+        location /file/static {
-        # 假设 http://upyun.xxx.com 为你的upyun存储
+            log_not_found off;
+            # 关闭日志
+            access_log off;
+            # 强缓存设置，缓存时间设置为0.5年
+            add_header Cache-Control "public, max-age=15768000";
             
-        location /upyun {
+            proxy_pass http://localhost:8080/api/common/static;
-            rewrite ^/upyun(.*)$ $1 break;
-            proxy_pass http://upyun.xxx.com;
-        }
-
-        location /static/upload {
-            proxy_pass http://upyun.xxx.com/static/upload;
-        }
-
-        location /static/bim2gltf {
-            proxy_pass http://upyun.xxx.com/static/bim2gltf;
         }
     }
    ```
@@ -155,12 +168,3 @@ nginx -s reload
 
 ## Docker 部署
 
-
-## 注意事项 
-1. 后端打包前请确认`Astral3DEditorGoBack/conf/app.conf`文件中的`runmode = prod`;
-2. 后端部署时，请确保 MySQL 数据库配置正确，并导入 `Astral3DEditorGoBack/static/sql/astral-3d-editor.sql` 文件；
-3. 前端部署时，请确保 Nginx 配置正确，并将前端部署到服务器上；
-4. 后端部署时，请确保后端程序启动成功，并监听 `Astral3DEditorGoBack/conf/app.conf`中配置的端口`httpport `，默认为 `8080` ；
-5. 前端部署时，请确保前端程序启动成功，并监听 Nginx 配置中配置的端口,比如上面示例的 `80` 端口；
-6. 部署完成后，请确保 Nginx 与 MySQL 服务正常运行；
-7. 部署完成后，请确保前端程序与后端程序正常运行；