makut/ht-backend

Hobby-Time backend

当前生产环境版本可查看：[***]

镜像概述

Hobby-Time backend镜像用于支撑Hobby-Time应用的后端服务，基于Node.js（TypeScript）开发，集成MongoDB数据库，提供用户、合作伙伴、爱好及评论等核心实体的管理功能，支持本地开发、生产部署及虚拟机运行等场景。

核心功能

1. 实体管理：用户、合作伙伴、爱好、评论等核心实体的CRUD操作
2. 环境适配：支持本地开发、生产环境及虚拟机运行配置
3. 安全管理：通过git secret加密存储敏感信息
4. 媒体上传：集成AWS云存储实现媒体文件上传
5. 自动化部署：通过Docker Hub自动构建镜像，支持版本回滚

使用场景

• 本地开发调试：快速搭建开发环境，实时监听代码变更
• 生产环境部署：通过Docker Compose一键启动后端、前端及Nginx负载均衡
• 虚拟机运行：利用Vagrant创建标准化虚拟环境，避免本地环境差异

配置说明

本地开发环境准备（Unix系统）

1. 安装nvm（Node版本管理工具）：

bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.2/install.sh | bash

2. 安装Node.js 10并设置默认版本：

bash
nvm install 10  
nvm use default 10  

3. 安装yarn包管理工具：参考https://classic.yarnpkg.com/en/docs/install#debian-stable
4. 配置git secret：用于加密敏感信息，需向仓库所有者提交GPG公钥获取解密权限

本地开发运行

bash
# 安装依赖  
yarn  
# 解密敏感信息（仅需一次）  
git secret reveal  
# 启动开发服务器（实时监听）  
yarn start:watch  

生产环境部署

1. 获取服务器登录信息（通过git secret解密）：

bash
git secret reveal  

2. SSH连接服务器：

bash
ssh <LOGIN>@<IP>  

3. 使用Docker Compose启动服务：

bash
# 拉取最新镜像  
docker-compose pull  
# 启动服务  
docker-compose up -d  

虚拟机运行（Vagrant）

1. 安装VirtualBox和Vagrant
2. 添加Ubuntu镜像：

bash
vagrant box add ubuntu/xenial64  

3. 启动虚拟机：

bash
FRONT_PATH=/path/to/front vagrant up  

4. 重启服务：

bash
vagrant provision --provision-with run  

5. 停止虚拟机：

bash
vagrant halt  

Docker部署示例

docker-compose.yml（简化版）

yaml
version: '3'  
services:  
  backend:  
    image: makut/ht-backend:latest  
    environment:  
      - NODE_ENV=production  
    ports:  
      - "3000:3000"  
    depends_on:  
      - mongo  
  mongo:  
    image: mongo:4.4  
    volumes:  
      - mongo-data:/data/db  
volumes:  
  mongo-data:  

启动命令：

bash
docker-compose up -d