swsc/mern

MERN-Boilerplate 镜像说明

镜像概述

本镜像为基于MERN栈（React、Express、MongoDB、Node.js）的Web应用开发模板，专为World of Code（WoC）项目设计。它整合了前端交互框架、后端服务架构、数据库操作工具及编译工具，提供完整的开发与部署支持。

核心功能

1. 前端开发: 使用React和React Router构建组件化界面，支持路由管理与交互式操作。
2. 后端服务: 通过Express框架提供RESTful API，结合Mongoose实现MongoDB数据模型与查询。
3. 资源编译: 利用Webpack完成前端资源的打包与优化。
4. 数据查询: 支持Lookup（代码对象查询）和Clickhouse数据库的API接口。
5. 容器化部署: 提供Docker配置，简化环境搭建与应用部署流程。

使用场景

• WoC项目开发人员快速搭建Web应用原型。
• 开发与测试代码对象查询、数据库交互等功能接口。
• 学习MERN栈在实际项目中的应用及Docker部署实践。

配置说明

前提条件

• Node.js 6+
• MongoDB

Docker部署示例

拉取镜像

bash
docker pull docker.xuanyuan.run/swsc/mern

运行容器（Option A）

bash
NID=your_netid  # 替换为你的NetID
PORT=9290       # 替换为可用端口
docker run -d --name mern$NID -v /home/$NID:/home/$NID -p $PORT:22 -w /home/$NID docker.xuanyuan.run/swsc/mern /bin/startsvc.sh $NID

本地连接容器

bash
ssh -p $PORT -L3001:localhost:443 -L3000:localhost:3000 -L3002:localhost:80 $NID@da2

项目结构

• 前端: client/目录包含React组件、路由配置和静态资源。
• 后端: server/目录包含数据库模型（models）、API路由（routes）和服务启动文件。
• 配置: config/config.js存储数据库连接和JWT密钥等信息。

扩展API路由

在server/routes/api/目录添加新路由文件（如foo.js）：

javascript
module.exports = (app) => {
  app.get('/api/foo/bar', (req, res) => {
    res.status(200).json({ message: 'Hello World!' });
  });
};

API使用示例

Lookup查询

bash
curl "http://worldofcode.org/api/lookup?command=showCnt&type=blob&sha1=8bfa9b6cde7b8d89abab622035c9fb002d10f157"

Clickhouse查询

bash
curl "[***]"