befly-tpl 3.4.12 → 3.4.14

package/SYSTEMD_DEPLOY.md

@@ -138,19 +138,15 @@ sudo systemctl restart befly
 
 ## 配置说明
 
-### 集群模式选择
+### 单进程模式
 
 ```ini
-# 选项1：单进程模式（适合小型应用）
+# Systemd 推荐单进程模式
 ExecStart=/usr/local/bin/bun run befly start
-
-# 选项2：自动集群模式（推荐，使用所有CPU核心）
-ExecStart=/usr/local/bin/bun run befly start --cluster max
-
-# 选项3：指定进程数（如4个进程）
-ExecStart=/usr/local/bin/bun run befly start --cluster 4
 ```
 
+**集群部署推荐使用 PM2**：Systemd 适合单进程部署，如需集群模式请使用 PM2（参见项目根目录的 PM2 相关文档）
+
 ### 用户和权限
 
 ```bash
@@ -193,18 +189,9 @@ EnvironmentFile=/var/www/befly/.env.production
 
 ### Nginx 配置示例
 
-```nginx
-upstream befly_cluster {
-    # 集群模式下配置多个端口
-    server 127.0.0.1:3000;
-    server 127.0.0.1:3001;
-    server 127.0.0.1:3002;
-    server 127.0.0.1:3003;
-
-    # 负载均衡策略
-    least_conn;  # 最少连接
-}
+#### 单进程模式
 
+```nginx
 server {
     listen 80;
     server_name yourdomain.com;
@@ -215,7 +202,7 @@ server {
     # ssl_certificate_key /path/to/key.pem;
 
     location / {
-        proxy_pass http://befly_cluster;
+        proxy_pass http://127.0.0.1:3000;
         proxy_http_version 1.1;
 
         # WebSocket 支持
@@ -306,7 +293,7 @@ sudo systemd-analyze verify /etc/systemd/system/befly.service
 
 # 测试启动命令
 cd /var/www/befly
-sudo -u www-data bun run befly start --cluster max
+sudo -u www-data bun run befly start
 ```
 
 ### 权限问题

package/main.ts

@@ -0,0 +1,4 @@
+import { Befly } from 'befly';
+
+const app = new Befly();
+await app.listen();

package/package.json

@@ -1,16 +1,25 @@
 {
     "name": "befly-tpl",
-    "version": "3.4.12",
+    "version": "3.4.14",
     "description": "Befly 3.0 TypeScript Template",
     "private": false,
     "publishConfig": {
         "access": "public",
         "registry": "https://registry.npmjs.org"
     },
-    "scripts": {},
+    "scripts": {
+        "dev": "bun run --env-file=.env.development main.ts",
+        "start": "bun run --env-file=.env.production main.ts",
+        "pm2:start": "pm2 start pm2.config.js --env production",
+        "pm2:dev": "pm2 start pm2.config.js --env development",
+        "sync:dev": "NODE_ENV=development befly sync",
+        "sync:prod": "NODE_ENV=production befly sync"
+    },
     "files": [
         "apis",
         "tables",
+        "main.ts",
+        "ecosystem.config.js",
         ".env.development",
         ".npmrc",
         "befly.service",
@@ -23,10 +32,10 @@
     ],
     "type": "module",
     "dependencies": {
-        "befly": "^3.4.11"
+        "befly": "^3.4.13"
     },
     "engines": {
         "bun": ">=1.3.0"
     },
-    "gitHead": "d7a5eef1df6a0b46ce3202839d4deb91ac3276f9"
+    "gitHead": "f37b14e9acad47245d399709829013fda8a0c44e"
 }

package/befly.service

@@ -1,93 +0,0 @@
-# Befly Systemd Service 配置文件
-#
-# 使用方法：
-# 1. 复制此文件到 /etc/systemd/system/befly.service
-#    sudo cp befly.service /etc/systemd/system/
-#
-# 2. 修改配置中的路径和用户信息
-#    sudo nano /etc/systemd/system/befly.service
-#
-# 3. 重载 systemd 配置
-#    sudo systemctl daemon-reload
-#
-# 4. 启动服务
-#    sudo systemctl start befly
-#
-# 5. 开机自启
-#    sudo systemctl enable befly
-#
-# 6. 查看状态
-#    sudo systemctl status befly
-#
-# 7. 查看日志
-#    sudo journalctl -u befly -f
-#
-# 8. 重启服务
-#    sudo systemctl restart befly
-#
-# 9. 停止服务
-#    sudo systemctl stop befly
-
-[Unit]
-Description=Befly Application Server
-Documentation=https://github.com/chenbimo/befly
-After=network.target
-
-[Service]
-Type=simple
-
-# 运行用户和组（根据实际情况修改）
-User=www-data
-Group=www-data
-
-# 工作目录（修改为实际项目路径）
-WorkingDirectory=/var/www/befly
-
-# 环境变量配置
-Environment="NODE_ENV=production"
-Environment="APP_PORT=3000"
-Environment="APP_HOST=0.0.0.0"
-
-# 启动命令
-# 单进程模式：
-# ExecStart=/usr/local/bin/bun run befly start
-#
-# 集群模式（推荐，自动使用所有CPU核心）：
-ExecStart=/usr/local/bin/bun run befly start --cluster max
-#
-# 集群模式（指定进程数）：
-# ExecStart=/usr/local/bin/bun run befly start --cluster 4
-
-# 重启策略
-Restart=always                    # 总是自动重启（崩溃、OOM、异常退出等）
-RestartSec=10                     # 重启前等待10秒
-StartLimitInterval=300            # 5分钟内
-StartLimitBurst=5                 # 最多重启5次（防止无限重启）
-
-# 资源限制
-MemoryMax=4G                      # 最大内存限制
-MemoryHigh=3G                     # 内存高水位警告
-LimitNOFILE=65536                 # 最大打开文件数
-LimitNPROC=4096                   # 最大进程数
-
-# CPU 限制（可选）
-# CPUQuota=200%                   # 最多使用2个CPU核心（200%）
-
-# 安全加固（可选，根据需要启用）
-# PrivateTmp=true                 # 使用私有 /tmp 目录
-# NoNewPrivileges=true            # 禁止提升权限
-# ProtectSystem=strict            # 保护系统目录只读
-# ProtectHome=true                # 保护家目录
-
-# 日志配置
-StandardOutput=journal            # 标准输出到 systemd journal
-StandardError=journal             # 错误输出到 systemd journal
-SyslogIdentifier=befly            # 日志标识符
-
-# 优雅关闭
-# KillMode=mixed                  # 混合模式：先 SIGTERM，超时后 SIGKILL
-# KillSignal=SIGTERM              # 发送 SIGTERM 信号
-# TimeoutStopSec=30               # 30秒后强制停止
-
-[Install]
-WantedBy=multi-user.target        # 多用户模式下启动