chore: 更新环境变量配置，添加 Puppeteer 可执行路径，优化 Dockerfile 构建流程

Author: ethanz-code

.env.development

@@ -1,2 +1,3 @@
 JWT_SECRET="42910EBF48299407B572A1521A73CCD73AD95204"
-SERVER_PORT="10010"
+SERVER_PORT="10010"
+PUPPETEER_EXECUTABLE_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"

.env.production

@@ -1,2 +1,3 @@
 JWT_SECRET="3FD9F4FF47CBFCD410039B80ADE1452613B66C59"
-SERVER_PORT="7777"
+SERVER_PORT="7777"
+PUPPETEER_EXECUTABLE_PATH="/usr/bin/chromium-browser"

.gitignore

@@ -1,5 +1,8 @@
 # Based on https://raw.githubusercontent.com/github/gitignore/main/Node.gitignore
 
+# building block
+entry
+
 # dotenvx private key
 .env.keys
 

README.md

@@ -35,15 +35,36 @@
 
 ### 标准接口
 
-> /pv 地址简化版
+| 接口路径           | 请求方法 | Content-Type     | 请求参数示例                                                             | 说明                     |
+| ------------------ | -------- | ---------------- | ------------------------------------------------------------------------ | ------------------------ |
+| /pv                | POST     | application/json | {<br> &nbsp;&nbsp; "url": "https://www.xiaohongshu.com/explore/xxx"<br>} | 解析短视频接口，简化地址 |
+| /public/parseVideo | POST     | application/json | {<br> &nbsp;&nbsp; "url": "https://www.xiaohongshu.com/explore/xxx"<br>} | 解析短视频接口           |
 
-```http
-POST /public/parseVideo
-Content-Type: application/json
+---
+
+## 环境变量说明
+
+- `PORT`：服务监听端口（开发环境建议 10010，生产环境建议 7777）
+- `PUPPETEER_EXECUTABLE_PATH`：指定 Puppeteer 启动时所用 Chromium/Chrome 浏览器的绝对路径，建议在 Docker 或服务器环境下设置为 `/usr/bin/chromium-browser`，否则 Puppeteer 可能无法正常启动。
+
+## 本地运行
+
+### 安装依赖
+
+```bash
+bun install
+```
+
+### 直接运行源代码
 
-{
-  "url": "https://v.douyin.com/xxxxx/"
-}
+```bash
+bun run dev
+```
+
+### 编译并运行
+
+```bash
+bun run build-local && bun run start
 ```
 
 ## Docker 镜像快速使用
@@ -71,7 +92,7 @@ docker run -d \
 
 ---
 
-如需更多高级用法（如数据持久化、日志挂载、反向代理等），请参考[详细部署文档](./docs/DEPLOYMENT.md)。
+详情内容请参考[详细部署文档](./docs/DEPLOYMENT.md)。
 
 如遇镜像拉取缓慢，可参考[镜像源配置指南](./docs/DOCKER_MIRROR.md)加速 Docker 镜像下载。
 

dockerfile

@@ -1,8 +1,19 @@
+# 第一阶段：构建阶段
+FROM oven/bun:1.1.21-alpine AS builder
+
+WORKDIR /app
+
+COPY package.json bun.lockb ./
+RUN bun install --frozen-lockfile
+
+COPY . .
+# 先删除旧的构建产物
+RUN rm -rf ./src/entry && bun run build
+
+# 第二阶段：生产镜像
 FROM oven/bun:1.1.21-alpine
 
-# 安装 Node.js 和 Chromium 依赖
 RUN apk add --no-cache \
-    nodejs \
     chromium \
     chromium-chromedriver \
     fontconfig \
@@ -16,33 +27,20 @@ RUN apk add --no-cache \
     wget \
     ca-certificates
 
-# Puppeteer 无头浏览器参数建议加上
-ENV PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium-browser
-
-# 设置工作目录
 WORKDIR /app
 
-# 复制 package.json 和 bun.lockb
-COPY package.json bun.lockb ./
-
-# 安装依赖
-RUN bun install --frozen-lockfile
-
-# 复制源代码
-COPY . .
-
-# 安装 PM2
-RUN bun add -g pm2
-
-# 创建日志目录
-RUN mkdir -p logs
+# 只复制构建产物和依赖
+COPY --from=builder /app/package.json /app/bun.lockb ./
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/src/entry ./src/entry
+COPY --from=builder /app/ecosystem.config.json ./
+COPY --from=builder /app/.env.production ./
 
-# 设置 Puppeteer 环境变量
 ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true \
-    PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium-browser
+    PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium-browser \
+    PORT=7777
 
-# 暴露端口
-EXPOSE 7777
+# 用环境变量控制端口暴露
+EXPOSE ${PORT}
 
-# 使用 PM2 Runtime 启动应用
-CMD ["pm2-runtime", "ecosystem.config.json"]
+CMD ["bun", "run", "start"]

docs/DEPLOYMENT.md

@@ -64,9 +64,22 @@ docker run -d \
 
 ## 环境变量说明
 
-必需的环境变量：
-
-- `PORT`: 服务器端口号（开发环境：10010, 生产环境：7777），具体可在环境变量文件查看
+- `PORT`：服务监听端口（开发环境建议 10010，生产环境建议 7777）
+- `PUPPETEER_EXECUTABLE_PATH`：指定 Puppeteer 启动时所用 Chromium/Chrome 浏览器的绝对路径，建议在 Docker 或服务器环境下设置为 `/usr/bin/chromium-browser`，否则 Puppeteer 可能无法正常启动。
+
+## 常用脚本说明
+
+- `bun run dev`：开发环境启动服务，自动加载 .env.development 环境变量。
+- `bun run build-local`：本地开发环境编译打包。
+- `bun run build`：生产环境编译打包，生成 Linux ARM64 可执行文件。
+- `bun run start`：直接运行编译后的入口文件。
+- `bun run format`：使用 Prettier 格式化全部代码。
+- `bun run encrypt-dev` / `bun run encrypt-prod`：加密开发/生产环境变量文件。
+- `bun run decrypt-dev` / `bun run decrypt-prod`：解密开发/生产环境变量文件。
+- `bun run dotenvx-help`：显示 dotenvx 版本及帮助信息。
+- `bun run pm2:dev`：用 PM2 启动开发环境。
+- `bun run pm2:start`：用 PM2 启动生产环境。
+- `bun run pm2:stop` / `bun run pm2:restart` / `bun run pm2:logs` / `bun run pm2:status`：PM2 进程管理相关命令。
 
 ## 更新维护
 

package.json

@@ -4,9 +4,9 @@
   "type": "module",
   "scripts": {
     "dev": "dotenvx run -f .env.development -- bun --watch src/index.ts",
-    "preview": "dotenvx run -f .env.production -- bun --watch src/index.ts",
-    "start": "dotenvx run -f .env.production --overload --debug -- bun --watch src/index.ts",
-    "test": "dotenvx run -f .env.development -- bun test",
+    "build-local": "dotenvx run -f .env.development -- bun build ./src/index.ts --compile --outfile ./src/entry",
+    "build": "dotenvx run -f .env.production -- bun build ./src/index.ts --compile --minify --target=bun-linux-amd64 --outfile ./src/entry",
+    "start": "./src/entry",
     "prepare-fallback": "husky install",
     "format": "prettier --write .",
     "separate-1": "------------------------------------------------------------",

src/bootstrap/server.ts

@@ -4,6 +4,8 @@ export const startServer = () => {
 	const PORT = Bun.env.SERVER_PORT || 7777;
 	const app = createApp();
 
+  console.log(Bun.env.PUPPETEER_EXECUTABLE_PATH);
+
 	app.listen(PORT, () =>
 		console.log(`Server is running on http://localhost:${PORT}`),
 	);

src/controllers/core/xiaohongshu.ts

@@ -36,7 +36,7 @@ export async function parseXiaohongshuContent({
   try {
     console.log("启动Puppeteer浏览器...");
     const browser = await puppeteer.launch({
-      executablePath: process.env.PUPPETEER_EXECUTABLE_PATH,
+      executablePath: Bun.env.PUPPETEER_EXECUTABLE_PATH,
       headless: true,
       args: [
         "--no-sandbox",