AwsLinker/STATIC_SERVER_README.md

静态文件服务器使用说明

本项目包含自定义的静态文件服务器，支持Next.js静态导出和自定义404页面。

🚀 快速开始

1. 构建静态文件

npm run build:static

2. 启动静态服务器

npm run preview

3. 访问网站

打开浏览器访问：http://localhost:8080

📋 可用命令

命令	说明
npm run preview	使用自定义服务器（推荐）
npm run preview:simple	使用Python简单服务器
node scripts/serve-static.js [端口]	直接运行Node.js服务器

✨ 功能特性

🎯 自定义404页面

• 智能语言检测
• 美观的错误页面设计
• 文章缺失特殊提示
• 快捷导航链接

🛡️ 安全特性

• 防止目录遍历攻击
• 安全HTTP头设置
• 适当的缓存控制

📱 路由处理

• 支持Next.js静态路由
• 自动index.html查找
• HTML扩展名自动补全

🔧 配置选项

端口配置

# 使用8080端口（默认）
npm run preview

# 使用自定义端口
node scripts/serve-static.js 3000

# 指定服务目录
node scripts/serve-static.js 8080 ./build

环境变量

无特殊环境变量要求，开箱即用。

🐛 故障排除

问题：端口已被占用

❌ 错误: 端口 8080 已被占用

解决方案：

# 使用其他端口
node scripts/serve-static.js 8081

问题：out目录不存在

❌ 错误: 目录 'out' 不存在

解决方案：

# 先构建静态文件
npm run build:static

问题：404页面不显示

确保以下文件存在：

• out/404.html （优先）
• public/404.html （备用）

📁 目录结构

project/
├── out/                    # 静态构建输出
│   ├── index.html         # 首页
│   ├── 404.html           # 自定义404页面
│   ├── zh-CN/             # 简体中文页面
│   ├── zh-TW/             # 繁体中文页面
│   └── en/                # 英文页面
├── scripts/
│   ├── serve-static.js    # Node.js静态服务器
│   └── serve-static.py    # Python静态服务器（备用）
└── public/
    └── 404.html           # 备用404页面

🌐 部署到生产环境

Nginx配置示例

server {
    listen 80;
    server_name your-domain.com;
    root /path/to/out;
    index index.html;

    # 处理Next.js路由
    location / {
        try_files $uri $uri.html $uri/ /404.html;
    }

    # 自定义404页面
    error_page 404 /404.html;
    
    # 静态资源缓存
    location ~* \.(css|js|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
}

Apache .htaccess配置

RewriteEngine On

# 处理Next.js路由
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ /$1.html [L]

# 如果HTML文件也不存在，返回404
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ /404.html [L]

# 自定义错误页面
ErrorDocument 404 /404.html

# 静态资源缓存
<FilesMatch "\.(css|js|png|jpg|jpeg|gif|ico|svg|woff|woff2)$">
    ExpiresActive On
    ExpiresDefault "access plus 1 year"
</FilesMatch>

📞 技术支持

如果遇到问题，请检查：

1. Node.js版本 >= 14
2. 静态文件已正确构建
3. 端口未被占用
4. 防火墙设置

---

注意： 生产环境建议使用专业的Web服务器（如Nginx、Apache）而不是Node.js静态服务器。