nsbp-cli 0.2.24 → 0.2.26

package/README.md

@@ -147,7 +147,7 @@ node ./bin/nsbp.js --help  # Test CLI locally
 
 - **Package Name**: `nsbp-cli`
 - **Bin Command**: `nsbp` (install globally and run `nsbp --help`)
-- **Version**: `0.2.24`
+- **Version**: `0.2.26`
 - **Dependencies**: chalk, commander, fs-extra, inquirer
 - **Package Manager**: Uses pnpm (also compatible with npm)
 - **Node Version**: >=16.0.0

package/bin/nsbp.js

@@ -55,19 +55,16 @@ program
         'src',
         'public',
         'scripts',
-        'webpack.base.js',
-        'webpack.client.js', 
-        'webpack.server.js',
+        'config',
+        'docker',
+        'docs',
+        '.env.example',
+        '.env.development',
+        '.env.production',
         'tsconfig.json',
-        'postcss.config.js',
         '.prettierrc',
         '.prettierignore',
         'gitignore',
-        '.dockerignore',
-        'docker-compose.yml',
-        'docker-compose.dev.yml',
-        'Dockerfile',
-        'Dockerfile.dev',
         'Makefile',
         'README.md'
       ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nsbp-cli",
-  "version": "0.2.24",
+  "version": "0.2.26",
   "description": "CLI tool for creating NSBP (Node React SSR by Webpack) projects",
   "main": "index.js",
   "homepage": "https://nsbp.erishen.cn/",

package/templates/basic/.env.development

@@ -0,0 +1,13 @@
+# NSBP 开发环境配置
+
+# ==================== 运行环境配置 ====================
+NODE_ENV=development
+PORT=3001
+
+# ==================== 安全配置 ====================
+# 开发环境禁用速率限制（影响开发效率）
+ENABLE_RATE_LIMIT=0
+
+# ==================== 调试配置 ====================
+# 启用详细日志便于调试
+# DEBUG=nsbp:*

package/templates/basic/.env.example

@@ -0,0 +1,33 @@
+# NSBP 环境变量配置
+# 复制此文件为 .env 并根据需要修改配置
+
+# ==================== 运行环境配置 ====================
+NODE_ENV=development
+PORT=3001
+
+# ==================== 安全配置 ====================
+# 启用速率限制（1=启用，0=禁用）
+# 开发环境建议禁用，生产环境建议启用
+ENABLE_RATE_LIMIT=0
+
+# ==================== Docker 配置（Docker 部署时使用）====================
+# Docker 镜像标签（可选）
+# DOCKER_IMAGE_TAG=latest
+
+# ==================== 调试配置 ====================
+# 启用详细日志（开发时有用）
+# DEBUG=nsbp:*
+
+# ==================== 性能配置 ====================
+# 启用性能监控（生产环境可选）
+# ENABLE_PERFORMANCE_MONITORING=0
+
+# ==================== 其他配置 ====================
+# 时区（可选）
+# TZ=Asia/Shanghai
+
+# ==================== 注意事项 ====================
+# 1. 不要将 .env 文件提交到 Git（已在 .gitignore 中忽略）
+# 2. 敏感信息（密钥、密码）请放在 .env.local 中
+# 3. .env.local 不会被提交到 Git，适合存放敏感信息
+# 4. 优先级：.env.local > .env > 默认值

package/templates/basic/.env.production

@@ -0,0 +1,17 @@
+# NSBP 生产环境配置
+
+# ==================== 运行环境配置 ====================
+NODE_ENV=production
+PORT=3001
+
+# ==================== 安全配置 ====================
+# 生产环境启用速率限制（防止 DDoS 和暴力攻击）
+ENABLE_RATE_LIMIT=1
+
+# ==================== 性能配置 ====================
+# 生产环境关闭调试日志
+# DEBUG=
+
+# ==================== 其他配置 ====================
+# 时区
+TZ=Asia/Shanghai

package/templates/basic/config/webpack.base.js

@@ -17,7 +17,21 @@ module.exports = ({ mode, entry, server, init }) => {
     entry,
     devtool: 'source-map',
     resolve: {
-      extensions: ['.ts', '.tsx', '.js', '.jsx', '.json']
+      extensions: ['.ts', '.tsx', '.js', '.jsx', '.json'],
+      alias: {
+        '@': path.resolve(__dirname, '../src'),
+        '@components': path.resolve(__dirname, '../src/component'),
+        '@utils': path.resolve(__dirname, '../src/utils'),
+        '@services': path.resolve(__dirname, '../src/services'),
+        '@styled': path.resolve(__dirname, '../src/styled'),
+        '@store': path.resolve(__dirname, '../src/store'),
+        '@reducers': path.resolve(__dirname, '../src/reducers'),
+        '@containers': path.resolve(__dirname, '../src/containers'),
+        '@server': path.resolve(__dirname, '../src/server'),
+        '@client': path.resolve(__dirname, '../src/client'),
+        '@css': path.resolve(__dirname, '../src/css'),
+        '@externals': path.resolve(__dirname, '../src/externals')
+      }
     },
     module: {
       rules: [

package/templates/basic/docs/ENV_CONFIG_GUIDE.md

@@ -0,0 +1,346 @@
+# NSBP 环境变量配置指南
+
+## 快速开始
+
+```bash
+# 1. 复制环境变量模板
+cp .env.example .env
+
+# 2. 根据需要编辑 .env
+nano .env
+
+# 3. 开始开发或部署
+pnpm run dev              # 本地开发
+docker-compose up -d         # Docker 部署
+```
+
+---
+
+## 配置文件说明
+
+### 文件优先级
+
+```
+.env.local (最高优先级) → .env → docker-compose.yml 默认值
+```
+
+### 文件列表
+
+| 文件名 | 说明 | 提交到 Git | 使用场景 |
+|-------|------|-----------|---------|
+| `.env.example` | 环境变量模板 | ✅ 提交 | 新项目初始化 |
+| `.env` | 默认环境配置 | ❌ 不提交 | 日常开发/部署 |
+| `.env.development` | 开发环境配置 | ❌ 不提交 | 切换到开发环境 |
+| `.env.production` | 生产环境配置 | ❌ 不提交 | 切换到生产环境 |
+| `.env.local` | 本地敏感信息 | ❌ 不提交 | 存储密钥、密码等 |
+
+---
+
+## 快速切换环境
+
+### 使用 Makefile（推荐）
+
+```bash
+# 切换到开发环境
+make env-dev
+
+# 切换到生产环境
+make env-prod
+
+# 创建本地配置文件
+make env-local
+
+# 查看当前配置
+make show-env
+```
+
+### 手动方式
+
+```bash
+# 切换到开发环境
+cp .env.development .env
+
+# 切换到生产环境
+cp .env.production .env
+
+# 创建本地配置
+cp .env.example .env.local
+```
+
+---
+
+## 环境变量说明
+
+### 基础配置
+
+```bash
+# 运行环境
+NODE_ENV=development        # 或 production
+
+# 服务端口
+PORT=3001
+
+# 时区
+TZ=Asia/Shanghai
+```
+
+### 安全配置
+
+```bash
+# 启用速率限制
+ENABLE_RATE_LIMIT=1        # 1=启用，0=禁用
+```
+
+**建议：**
+- ✅ 开发环境：`ENABLE_RATE_LIMIT=0`（不影响开发效率）
+- ✅ 生产环境：`ENABLE_RATE_LIMIT=1`（防止 DDoS 攻击）
+
+### 调试配置
+
+```bash
+# 启用详细日志
+DEBUG=nsbp:*
+```
+
+---
+
+## 使用场景
+
+### 场景 1：新项目初始化
+
+```bash
+# 1. 克隆项目
+git clone <repository-url>
+cd nsbp
+
+# 2. 复制环境变量模板
+cp .env.example .env
+
+# 3. 安装依赖
+pnpm install
+
+# 4. 启动开发环境
+pnpm run dev
+```
+
+### 场景 2：日常开发
+
+```bash
+# 使用开发环境配置
+make env-dev
+
+# 启动开发环境
+pnpm run dev
+```
+
+### 场景 3：Docker 部署
+
+```bash
+# 切换到生产环境
+make env-prod
+
+# 启动 Docker 容器
+docker-compose up -d
+
+# 查看日志
+docker-compose logs -f
+```
+
+### 场景 4：敏感信息管理
+
+```bash
+# 1. 创建本地配置文件
+make env-local
+
+# 2. 编辑 .env.local 添加敏感信息
+nano .env.local
+
+# 添加内容：
+# DATABASE_URL=postgresql://user:pass@localhost:5432/db
+# API_SECRET=your-secret-key
+# JWT_SECRET=jwt-secret-key
+
+# .env.local 会自动覆盖 .env 中的同名变量
+```
+
+---
+
+## 最佳实践
+
+### ✅ 推荐做法
+
+1. **始终使用 .env 文件**
+   ```bash
+   # 不要在代码中硬编码
+   const PORT = process.env.PORT || 3001  # ✅
+   const PORT = 3001  # ❌
+   ```
+
+2. **分离敏感信息**
+   ```bash
+   # .env - 非敏感配置（可以分享给团队）
+   NODE_ENV=development
+   PORT=3001
+   ENABLE_RATE_LIMIT=0
+
+   # .env.local - 敏感配置（个人使用）
+   DATABASE_URL=postgresql://localhost/db
+   API_KEY=secret-key-123
+   ```
+
+3. **提供 .env.example**
+   ```bash
+   # .env.example - 示例配置（提交到 Git）
+   NODE_ENV=development
+   PORT=3001
+   ENABLE_RATE_LIMIT=0
+   # API_KEY=your-api-key  # 提供示例，不包含真实值
+   ```
+
+4. **使用环境前缀**
+   ```bash
+   # 命名规范
+   NSBP_NODE_ENV=development
+   NSBP_PORT=3001
+   NSBP_ENABLE_RATE_LIMIT=0
+   ```
+
+### ❌ 避免做法
+
+1. **不要提交 .env 到 Git**
+   ```bash
+   # .gitignore 已包含
+   .env
+   .env.local
+   .env.*.local
+   ```
+
+2. **不要在代码中硬编码敏感信息**
+   ```javascript
+   // ❌ 错误做法
+   const dbPassword = "my-password-123"
+   
+   // ✅ 正确做法
+   const dbPassword = process.env.DB_PASSWORD
+   ```
+
+3. **不要在 .env.example 中包含真实值**
+   ```bash
+   # .env.example - 只提供示例
+   API_KEY=your-api-key-here  # ✅
+   API_KEY=sk-1234567890abcdef  # ❌
+   ```
+
+---
+
+## Docker Compose 集成
+
+### 自动读取 .env
+
+Docker Compose 会自动读取项目根目录下的 `.env` 文件：
+
+```yaml
+# docker-compose.yml
+services:
+  app:
+    environment:
+      - NODE_ENV=${NODE_ENV:-production}
+      - PORT=${PORT:-3001}
+      - ENABLE_RATE_LIMIT=${ENABLE_RATE_LIMIT:-1}
+```
+
+### 使用方式
+
+```bash
+# 1. 创建 .env 文件
+cp .env.production .env
+
+# 2. Docker Compose 自动读取
+docker-compose up -d
+
+# 3. 验证环境变量
+docker-compose exec app env | grep NODE_ENV
+```
+
+---
+
+## 故障排除
+
+### 问题 1：环境变量未生效
+
+**检查步骤：**
+```bash
+# 1. 检查 .env 文件是否存在
+ls -la .env
+
+# 2. 查看文件内容
+cat .env
+
+# 3. 验证格式（等号两边不要有空格）
+NODE_ENV=development  # ✅
+NODE_ENV = development  # ❌
+
+# 4. 重启服务
+docker-compose restart
+```
+
+### 问题 2：敏感信息泄露
+
+**预防措施：**
+```bash
+# 1. 检查 .gitignore
+cat .gitignore | grep .env
+
+# 2. 验证文件未被提交
+git ls-files | grep .env
+
+# 3. 如果已提交，从历史记录中移除
+git filter-branch --force --index-filter \
+  'git rm --cached --ignore-unmatch .env'
+```
+
+### 问题 3：环境变量优先级混乱
+
+**验证方法：**
+```bash
+# 1. 显示容器中的环境变量
+docker-compose exec app env | sort
+
+# 2. 查看实际生效的值
+docker-compose exec app sh -c 'echo $NODE_ENV'
+
+# 3. 检查 .env.local 是否覆盖了预期值
+cat .env.local | grep NODE_ENV
+```
+
+---
+
+## 常用命令速查
+
+```bash
+# 查看当前配置
+make show-env
+
+# 切换开发环境
+make env-dev
+
+# 切换生产环境
+make env-prod
+
+# 创建本地配置
+make env-local
+
+# 查看容器环境变量
+docker-compose exec app env
+
+# 验证特定变量
+docker-compose exec app sh -c 'echo $ENABLE_RATE_LIMIT'
+```
+
+---
+
+## 参考资源
+
+- [Docker Compose 环境变量](https://docs.docker.com/compose/environment-variables/)
+- [Node.js process.env](https://nodejs.org/api/process.html#process_process_env)
+- [十二因子应用](https://12factor.net/)

package/templates/basic/docs/QUICKSTART.md

@@ -0,0 +1,99 @@
+# Docker 快速启动指南
+
+🌐 **Online Demo**: [https://nsbp.erishen.cn/](https://nsbp.erishen.cn/)
+
+## 5 分钟快速开始
+
+### 生产环境（推荐用于生产部署）
+
+```bash
+# 1. 构建并启动
+docker-compose up -d
+
+# 2. 查看状态
+docker-compose ps
+
+# 3. 查看日志（可选）
+docker-compose logs -f
+
+# 4. 访问应用
+open http://localhost:3001
+```
+
+完成！🎉
+
+### 开发环境（推荐用于开发）
+
+```bash
+# 1. 构建并启动（前台运行，可查看构建日志）
+docker-compose -f docker-compose.dev.yml up --build
+
+# 2. 等待看到 "Server listening on port 3001"
+# （首次启动需要 1-3 分钟进行构建）
+
+# 3. 访问应用
+open http://localhost:3001
+
+# 4. 修改代码，自动热重载
+```
+
+**提示：** 如果想在后台运行：
+```bash
+docker-compose -f docker-compose.dev.yml up -d --build
+docker-compose -f docker-compose.dev.yml logs -f
+```
+
+## 常用命令
+
+### 生产环境
+```bash
+make prod         # 启动
+make logs         # 查看日志
+make restart      # 重启
+make down         # 停止
+make clean        # 完全清理
+```
+
+### 开发环境
+```bash
+make dev          # 启动（带热重载）
+make logs-dev     # 查看日志
+make restart-dev   # 重启
+```
+
+### 通用
+```bash
+make help         # 查看所有命令
+make shell        # 进入生产容器
+make shell-dev    # 进入开发容器
+```
+
+## 验证安装
+
+检查 Docker 是否正确安装：
+```bash
+docker --version
+docker-compose --version
+```
+
+测试配置：
+```bash
+./scripts/verify-dev.sh
+```
+
+## 遇到问题？
+
+- 查看 README.md 中的 Docker 部署章节
+- 运行 `./scripts/verify-dev.sh` 验证开发环境状态
+- 确保 Docker 守护进程正在运行
+
+## 目录说明
+
+- `Dockerfile` - 生产环境镜像
+- `Dockerfile.dev` - 开发环境镜像
+- `docker-compose.yml` - 生产环境配置
+- `docker-compose.dev.yml` - 开发环境配置
+- `Makefile` - 快捷命令
+- `scripts/verify-dev.sh` - 开发环境验证脚本
+- `README.md` - 完整文档
+- `QUICKSTART.md` - 本文档

package/templates/basic/gitignore

@@ -3,9 +3,6 @@ Thumbs.db
 
 # Dependencies
 node_modules
-package-lock.json
-yarn.lock
-pnpm-lock.yaml
 
 # Build outputs
 build

package/templates/basic/src/Routers.tsx

@@ -1,21 +1,21 @@
 import React from 'react'
-import { loadData as homeLoadData } from './services/home'
-import { loadData as photoLoadData } from './services/photo'
+import { loadData as homeLoadData } from '@services/home'
+import { loadData as photoLoadData } from '@services/photo'
 import loadable from "@loadable/component"
 
 const Loading = () => {
   return <div>Loading...</div>
 }
 
-const Home = loadable(() => import("./containers/Home"), {
+const Home = loadable(() => import("@containers/Home"), {
   fallback: <Loading />
 })
 
-const Login = loadable(() => import("./containers/Login"), {
+const Login = loadable(() => import("@containers/Login"), {
   fallback: <Loading />
 })
 
-const Photo = loadable(() => import("./containers/Photo"), {
+const Photo = loadable(() => import("@containers/Photo"), {
   fallback: <Loading />
 })
 

package/templates/basic/src/client/index.tsx

@@ -1,11 +1,11 @@
 import React, { useEffect, useState } from 'react'
 import { hydrateRoot } from 'react-dom/client'
 import { BrowserRouter, Routes, Route } from 'react-router-dom'
-import routers from '../Routers'
+import routers from '@/Routers'
 import { Provider } from 'react-redux'
-import getStore from '../store'
-import { isSEO } from '../utils'
-import Theme from '../component/Theme'
+import getStore from '@/store'
+import { isSEO } from '@/utils'
+import Theme from '@components/Theme'
 import { loadableReady } from '@loadable/component'
 
 const App = () => {

package/templates/basic/src/component/Header.tsx

@@ -1,6 +1,6 @@
 import React from 'react'
 import { Link, useLocation } from 'react-router-dom'
-import { Container, LogoWrapper as Logo, Nav, NavLink, Brand } from '../styled/component/header'
+import { Container, LogoWrapper as Logo, Nav, NavLink, Brand } from '@styled/component/header'
 
 const Header = () => {
   const location = useLocation()

package/templates/basic/src/server/index.ts

@@ -1,9 +1,9 @@
 import express from 'express'
 import helmet from 'helmet'
 import rateLimit from 'express-rate-limit'
-import { render } from './utils'
-import { getPhotoWH, getPhotoMenu } from './photo'
-import { useCurrentFlag, outPhotoDicPath } from '../utils/config'
+import { render } from '@server/utils'
+import { getPhotoWH, getPhotoMenu } from '@server/photo'
+import { useCurrentFlag, outPhotoDicPath } from '@utils/config'
 
 const app = express()
 

package/templates/basic/tsconfig.json

@@ -13,7 +13,22 @@
     "allowSyntheticDefaultImports": true,
     "esModuleInterop": true,
     "preserveConstEnums": true,
-    "skipLibCheck": true
+    "skipLibCheck": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"],
+      "@components/*": ["./src/component/*"],
+      "@utils/*": ["./src/utils/*"],
+      "@services/*": ["./src/services/*"],
+      "@styled/*": ["./src/styled/*"],
+      "@store/*": ["./src/store/*"],
+      "@reducers/*": ["./src/reducers/*"],
+      "@containers/*": ["./src/containers/*"],
+      "@server/*": ["./src/server/*"],
+      "@client/*": ["./src/client/*"],
+      "@css/*": ["./src/css/*"],
+      "@externals/*": ["./src/externals/*"]
+    }
   },
   "include":[
     "./src/**/*",