# express-proxy-server

**Repository Path**: mayeyun/express-proxy-server

## Basic Information

- **Project Name**: express-proxy-server
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-28
- **Last Updated**: 2025-10-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Express 静态文件服务器

## 项目介绍

这是一个基于 Express.js 框架搭建的静态文件服务器，专门用于托管 HTML 静态网页。项目结构简单清晰，适合前端开发新手使用。服务器支持两个独立的静态文件目录：

- `/public/user`: 用于存放用户端相关的静态文件
- `/public/admin`: 用于存放管理后台相关的静态文件

## 目录结构

```
express-proxy-server/
├── LICENSE
├── package.json          # 项目依赖配置文件
├── README.md            # 项目说明文档
├── server.js            # 服务器主程序
└── public/              # 静态资源目录
    ├── admin/          # 管理后台静态文件
    │   └── index.html  # 管理后台首页
    └── user/           # 用户端静态文件
        └── index.html  # 用户端首页
```

## 环境准备

### 1. 安装 Git

Git 是一个版本控制工具，用于下载和管理代码。

**Windows 系统：**

1. 访问 [Git 官网](https://git-scm.com/downloads) 下载 Windows 版本
2. 运行下载的安装包，全程点击"Next"即可
3. 安装完成后，在开始菜单中找到"Git Bash"并运行
4. 验证安装：在 Git Bash 中输入 `git --version`，如显示版本号则安装成功

**macOS 系统：**

1. 打开"终端"应用
2. 输入命令：`xcode-select --install`，按提示安装
3. 验证安装：输入 `git --version`，如显示版本号则安装成功

### 2. 安装 Node.js

Node.js 是运行 JavaScript 代码的环境，我们的服务器需要它来运行。

**所有系统：**

1. 访问 [Node.js 官网](https://nodejs.org/)
2. 下载"长期支持版"（LTS）
3. 运行安装包，按默认选项安装
4. 验证安装：
   - Windows：打开命令提示符（cmd）
   - macOS：打开终端
     输入：
   ```bash
   node --version
   npm --version
   ```
   如果都显示版本号，则安装成功

## 项目部署

### 1. 获取代码

```bash
# 克隆项目到本地
git clone <项目Git地址>

# 进入项目目录
cd express-proxy-server
```

### 2. 安装项目依赖

在项目目录下运行：

```bash
# 安装项目所需的所有依赖
npm install
```

### 3. 启动服务器

有两种方式可以启动服务器：

方式一（推荐）：使用 npm 启动

```bash
# 启动服务器
npm start
```

方式二：直接使用 node 启动

```bash
# 启动服务器
node server.js
```

> 说明：这两种方式是等价的，因为在 `package.json` 中已经配置了启动脚本：
>
> ```json
> "scripts": {
>     "start": "node server.js"
> }
> ```

看到以下输出说明服务器启动成功：

```
Server is running on http://localhost:3000
```

服务器启动后：

1. 保持命令行窗口打开
2. 不要按 Ctrl+C（Windows）或 Command+C（Mac），否则会停止服务器
3. 要停止服务器，可以按 Ctrl+C（Windows）或 Command+C（Mac）
4. 如果要重启服务器，先按 Ctrl+C 停止，然后重新运行 `npm start`

## 使用说明

### 1. 访问网页

- 用户端页面：http://localhost:3000/user
- 管理后台：http://localhost:3000/admin

### 2. 添加新的 HTML 文件

1. 用户端页面：

   - 将 HTML 文件放入 `public/user/` 目录
   - 访问地址：`http://localhost:3000/user/你的文件名.html`

2. 管理后台页面：
   - 将 HTML 文件放入 `public/admin/` 目录
   - 访问地址：`http://localhost:3000/admin/你的文件名.html`

### 3. 添加其他资源文件

- CSS 文件：放入相应目录（user 或 admin）下
- 图片：建议创建 images 文件夹存放
- JavaScript 文件：建议创建 js 文件夹存放

例如：

```
public/user/
    ├── css/
    │   └── style.css
    ├── js/
    │   └── main.js
    ├── images/
    │   └── logo.png
    └── index.html
```

## 常见问题

1. **端口被占用**
   如果启动时提示"端口 3000 被占用"，可以修改 `server.js` 中的端口号：

   ```javascript
   const PORT = 3000; // 改为其他数字，如3001
   ```

2. **文件没有更新**

   - 确保文件保存后刷新浏览器缓存（Windows: Ctrl+F5, Mac: Cmd+Shift+R）
   - 检查文件路径是否正确

3. **npm 安装报错**
   ```bash
   # 清除npm缓存后重试
   npm cache clean --force
   npm install
   ```

## 技术支持

如遇到问题，请：

1. 检查以上常见问题
2. 在项目 Issues 中提问
3. 联系项目维护者

## License

MIT License - 详见 LICENSE 文件