From 92a57d99a002e7fc19d3542f4e681d2d9061bed7 Mon Sep 17 00:00:00 2001 From: Odboy Date: Sun, 15 Nov 2026 11:50:49 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=20node-frontend-vue3?= =?UTF-8?q?=20=E7=A4=BA=E4=BE=8B=EF=BC=88Vue=203=20+=20Element=20Plus?= =?UTF-8?q?=EF=BC=8CTengine=20=E6=89=98=E7=AE=A1=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- demo/app/node-frontend-vue3/.dockerignore | 4 + demo/app/node-frontend-vue3/.gitignore | 3 + demo/app/node-frontend-vue3/Dockerfile | 23 +++++ demo/app/node-frontend-vue3/README.md | 74 +++++++++++++++ demo/app/node-frontend-vue3/build.sh | 11 +++ .../app/node-frontend-vue3/docker-compose.yml | 32 +++++++ demo/app/node-frontend-vue3/index.html | 12 +++ .../nginx/node-frontend-vue3.conf | 29 ++++++ demo/app/node-frontend-vue3/package.json | 24 +++++ demo/app/node-frontend-vue3/shutdown.sh | 4 + demo/app/node-frontend-vue3/src/App.vue | 19 ++++ demo/app/node-frontend-vue3/src/main.js | 10 ++ demo/app/node-frontend-vue3/src/router.js | 15 +++ demo/app/node-frontend-vue3/src/styles.css | 20 ++++ .../src/views/AboutView.vue | 16 ++++ .../node-frontend-vue3/src/views/FormView.vue | 55 +++++++++++ .../node-frontend-vue3/src/views/HomeView.vue | 94 +++++++++++++++++++ demo/app/node-frontend-vue3/startup.sh | 5 + demo/app/node-frontend-vue3/vite.config.js | 25 +++++ 19 files changed, 475 insertions(+) create mode 100644 demo/app/node-frontend-vue3/.dockerignore create mode 100644 demo/app/node-frontend-vue3/.gitignore create mode 100644 demo/app/node-frontend-vue3/Dockerfile create mode 100644 demo/app/node-frontend-vue3/README.md create mode 100755 demo/app/node-frontend-vue3/build.sh create mode 100644 demo/app/node-frontend-vue3/docker-compose.yml create mode 100644 demo/app/node-frontend-vue3/index.html create mode 100644 demo/app/node-frontend-vue3/nginx/node-frontend-vue3.conf create mode 100644 demo/app/node-frontend-vue3/package.json create mode 100755 demo/app/node-frontend-vue3/shutdown.sh create mode 100644 demo/app/node-frontend-vue3/src/App.vue create mode 100644 demo/app/node-frontend-vue3/src/main.js create mode 100644 demo/app/node-frontend-vue3/src/router.js create mode 100644 demo/app/node-frontend-vue3/src/styles.css create mode 100644 demo/app/node-frontend-vue3/src/views/AboutView.vue create mode 100644 demo/app/node-frontend-vue3/src/views/FormView.vue create mode 100644 demo/app/node-frontend-vue3/src/views/HomeView.vue create mode 100755 demo/app/node-frontend-vue3/startup.sh create mode 100644 demo/app/node-frontend-vue3/vite.config.js diff --git a/demo/app/node-frontend-vue3/.dockerignore b/demo/app/node-frontend-vue3/.dockerignore new file mode 100644 index 0000000..89fe1f0 --- /dev/null +++ b/demo/app/node-frontend-vue3/.dockerignore @@ -0,0 +1,4 @@ +dist/ +node_modules/ +.git/ +.DS_Store diff --git a/demo/app/node-frontend-vue3/.gitignore b/demo/app/node-frontend-vue3/.gitignore new file mode 100644 index 0000000..1061ea7 --- /dev/null +++ b/demo/app/node-frontend-vue3/.gitignore @@ -0,0 +1,3 @@ +dist/ +node_modules/ +npm-debug.log* diff --git a/demo/app/node-frontend-vue3/Dockerfile b/demo/app/node-frontend-vue3/Dockerfile new file mode 100644 index 0000000..982da16 --- /dev/null +++ b/demo/app/node-frontend-vue3/Dockerfile @@ -0,0 +1,23 @@ +# 编译阶段:compile-node22(Vite 7 需要 Node >= 20.19) +FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-node22 AS build +WORKDIR /src + +COPY package.json package-lock.json* ./ +# npm 源由镜像的 /usr/local/node/etc/npmrc 指向 npmmirror,无需额外换源 +RUN npm install --no-audit --no-fund + +COPY . ./ +RUN npm run build && ls -lh dist/ dist/assets/ + +# 运行阶段:Tengine 3.1.0(自建 proxy-tengine3 镜像)托管静态文件 +FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:proxy-tengine3 AS runtime +LABEL MAINTAINER="tianjun@odboy.cn" +ENV TimeZone=Asia/Shanghai +# 站点配置与构建产物都放进镜像:conf.d/*.conf 由主配置 include,html/ 为站点根目录 +COPY nginx/node-frontend-vue3.conf /usr/local/nginx/conf/conf.d/node-frontend-vue3.conf +COPY --from=build /src/dist/ /usr/local/nginx/html/ +# 构建期自检:配置语法错误直接让镜像构建失败;纯静态站点没有上游主机名,nginx -t 可直接通过 +RUN /usr/local/nginx/sbin/nginx -t -c /usr/local/nginx/conf/nginx.conf +EXPOSE 80 +STOPSIGNAL SIGQUIT +CMD ["/usr/local/nginx/sbin/nginx", "-g", "daemon off;"] diff --git a/demo/app/node-frontend-vue3/README.md b/demo/app/node-frontend-vue3/README.md new file mode 100644 index 0000000..7d6f5cf --- /dev/null +++ b/demo/app/node-frontend-vue3/README.md @@ -0,0 +1,74 @@ +# node-frontend-vue3 示例 + +Vue 3 + Element Plus 的前端项目,**构建阶段**用 `compile-node22` 跑 Vite,**运行阶段**以自建 +`proxy-tengine3` 镜像为基座托管静态文件。与 [`node-frontend-vue2`](../node-frontend-vue2/README.md) 对照, +差别只在框架版本与 UI 库。 + +| 阶段 | 镜像 | 说明 | +| --- | --- | --- | +| 编译 | `registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-node22` | Node 22 + npm(源为 npmmirror),Vite 7 要求 Node ≥ 20.19 | +| 运行 | `registry.cn-shanghai.aliyuncs.com/odboy/kenaito:proxy-tengine3` | Tengine 3.1.0,托管 `dist/` | + +纯前端项目:页面数据全部在浏览器内产生,不调用任何后端接口,部署只需要一个 Tengine 容器。 + +### 示例内容 + +``` +node-frontend-vue3/ +├── package.json # vue 3.5.45 / element-plus 2.14.8 / vue-router 4.6.5;vite 7 + plugin-vue 6 +├── vite.config.js # base: './';element-plus 单独拆包 +├── index.html +├── src/ +│ ├── main.js # createApp().use(router).use(ElementPlus) +│ ├── router.js # createWebHashHistory,/ /form /about +│ ├── App.vue # + + diff --git a/demo/app/node-frontend-vue3/nginx/node-frontend-vue3.conf b/demo/app/node-frontend-vue3/nginx/node-frontend-vue3.conf new file mode 100644 index 0000000..e08e784 --- /dev/null +++ b/demo/app/node-frontend-vue3/nginx/node-frontend-vue3.conf @@ -0,0 +1,29 @@ +# node-frontend-vue3 站点:Tengine 3.1.0 托管 Vue 3 构建产物(纯静态,无后端依赖) +server { + listen 80; + server_name _; + + access_log /dev/stdout main; + + root /usr/local/nginx/html; + index index.html; + + # 静态资源带 hash,长缓存;index.html 每次重新验证,保证发版后立即生效 + location /assets/ { + expires 30d; + add_header Cache-Control "public, immutable"; + try_files $uri =404; + } + + # 前端路由兜底:hash 模式下用不到,保留是为了以后切 history 模式时不用改配置 + location / { + try_files $uri $uri/ /index.html; + } + + # 健康检查:直接读 index.html + location = /healthz { + access_log off; + default_type text/plain; + return 200 "ok\n"; + } +} diff --git a/demo/app/node-frontend-vue3/package.json b/demo/app/node-frontend-vue3/package.json new file mode 100644 index 0000000..1b161bf --- /dev/null +++ b/demo/app/node-frontend-vue3/package.json @@ -0,0 +1,24 @@ +{ + "name": "node-frontend-vue3", + "version": "1.0.0", + "private": true, + "description": "Vue 3 + Element Plus 前端示例,构建产物由 Tengine 托管", + "type": "module", + "engines": { + "node": ">=20.19" + }, + "scripts": { + "dev": "vite", + "build": "vite build", + "preview": "vite preview --port 4173" + }, + "dependencies": { + "element-plus": "2.14.8", + "vue": "3.5.45", + "vue-router": "4.6.5" + }, + "devDependencies": { + "@vitejs/plugin-vue": "6.0.11", + "vite": "7.3.8" + } +} diff --git a/demo/app/node-frontend-vue3/shutdown.sh b/demo/app/node-frontend-vue3/shutdown.sh new file mode 100755 index 0000000..6ec29ca --- /dev/null +++ b/demo/app/node-frontend-vue3/shutdown.sh @@ -0,0 +1,4 @@ +#!/usr/bin/env bash +set -euo pipefail +cd "$(dirname "$0")" +docker-compose -f docker-compose.yml -p node-frontend-vue3-demo down diff --git a/demo/app/node-frontend-vue3/src/App.vue b/demo/app/node-frontend-vue3/src/App.vue new file mode 100644 index 0000000..5af0f94 --- /dev/null +++ b/demo/app/node-frontend-vue3/src/App.vue @@ -0,0 +1,19 @@ + + + diff --git a/demo/app/node-frontend-vue3/src/main.js b/demo/app/node-frontend-vue3/src/main.js new file mode 100644 index 0000000..22d0114 --- /dev/null +++ b/demo/app/node-frontend-vue3/src/main.js @@ -0,0 +1,10 @@ +import { createApp } from 'vue'; +import ElementPlus from 'element-plus'; +import 'element-plus/dist/index.css'; +import './styles.css'; + +import App from './App.vue'; +import router from './router'; + +// Vue 3 组合式写法 + Element Plus +createApp(App).use(router).use(ElementPlus).mount('#app'); diff --git a/demo/app/node-frontend-vue3/src/router.js b/demo/app/node-frontend-vue3/src/router.js new file mode 100644 index 0000000..06c31b1 --- /dev/null +++ b/demo/app/node-frontend-vue3/src/router.js @@ -0,0 +1,15 @@ +import { createRouter, createWebHashHistory } from 'vue-router'; +import Home from './views/HomeView.vue'; + +const routes = [ + { path: '/', name: 'home', component: Home }, + { path: '/form', name: 'form', component: () => import('./views/FormView.vue') }, + { path: '/about', name: 'about', component: () => import('./views/AboutView.vue') }, + // 前端路由兜底:hash 模式下用不到,Tengine 的 location / 里已经配了 try_files + { path: '/:pathMatch(.*)*', redirect: '/' }, +]; + +export default createRouter({ + history: createWebHashHistory(), + routes, +}); diff --git a/demo/app/node-frontend-vue3/src/styles.css b/demo/app/node-frontend-vue3/src/styles.css new file mode 100644 index 0000000..8a635a8 --- /dev/null +++ b/demo/app/node-frontend-vue3/src/styles.css @@ -0,0 +1,20 @@ +html, +body, +#app { + height: 100%; + margin: 0; +} + +.header { + display: flex; + align-items: center; + gap: 24px; + background: #fff; + border-bottom: 1px solid var(--el-border-color-light); +} + +.logo { + font-size: 18px; + font-weight: 600; + color: var(--el-color-primary); +} diff --git a/demo/app/node-frontend-vue3/src/views/AboutView.vue b/demo/app/node-frontend-vue3/src/views/AboutView.vue new file mode 100644 index 0000000..732cbdd --- /dev/null +++ b/demo/app/node-frontend-vue3/src/views/AboutView.vue @@ -0,0 +1,16 @@ + + + diff --git a/demo/app/node-frontend-vue3/src/views/FormView.vue b/demo/app/node-frontend-vue3/src/views/FormView.vue new file mode 100644 index 0000000..b96c43e --- /dev/null +++ b/demo/app/node-frontend-vue3/src/views/FormView.vue @@ -0,0 +1,55 @@ + + + diff --git a/demo/app/node-frontend-vue3/src/views/HomeView.vue b/demo/app/node-frontend-vue3/src/views/HomeView.vue new file mode 100644 index 0000000..05b7257 --- /dev/null +++ b/demo/app/node-frontend-vue3/src/views/HomeView.vue @@ -0,0 +1,94 @@ + + + + + diff --git a/demo/app/node-frontend-vue3/startup.sh b/demo/app/node-frontend-vue3/startup.sh new file mode 100755 index 0000000..77b9f15 --- /dev/null +++ b/demo/app/node-frontend-vue3/startup.sh @@ -0,0 +1,5 @@ +#!/usr/bin/env bash +set -euo pipefail +cd "$(dirname "$0")" +docker-compose -f docker-compose.yml -p node-frontend-vue3-demo up -d +docker-compose -f docker-compose.yml -p node-frontend-vue3-demo ps diff --git a/demo/app/node-frontend-vue3/vite.config.js b/demo/app/node-frontend-vue3/vite.config.js new file mode 100644 index 0000000..e20d3ba --- /dev/null +++ b/demo/app/node-frontend-vue3/vite.config.js @@ -0,0 +1,25 @@ +import { defineConfig } from 'vite'; +import vue from '@vitejs/plugin-vue'; + +// 纯静态前端:产物由 Tengine 托管,base 用相对路径,部署到任意子路径都能跑 +export default defineConfig({ + plugins: [vue()], + base: './', + server: { + host: '0.0.0.0', + port: 5273, + }, + build: { + outDir: 'dist', + sourcemap: false, + // element-plus 体积较大,单独拆包,利用浏览器缓存 + rollupOptions: { + output: { + manualChunks: { + 'element-plus': ['element-plus'], + vue: ['vue', 'vue-router'], + }, + }, + }, + }, +});