nostalgia

Nostalgia 个人博客系统

Nostalgia 是一个基于 Golang + gRPC + Gin + Redis + PostgreSQL + Docker 的博客系统，支持 Web 前台展示与后台内容管理，内置文件上传、任务队列、权限管理等功能。

🚀 适用于个人博客、中小型内容系统、全栈开发练习项目。

📂 项目结构

NOSTALGIA/
├── .github/ # GitHub CI/CD workflows 配置
├── api/ # Gin HTTP 服务（博客前台 API）
├── db/ # 数据库迁移脚本与 SQLC 定义
├── doc/ # 项目文档（含 statik 嵌入）
├── gapi/ # gRPC 服务实现（博客后台 API）
├── internal/ # 内部服务模块（如 Redis 封装）
├── mail/ # 邮件服务模块
├── pb/ # Protocol Buffers 编译输出
├── proto/ # gRPC 接口定义（.proto 文件）
├── resources/ # 上传资源文件目录（图片、附件等）
├── token/ # JWT / Paseto 认证逻辑
├── util/ # 配置加载与工具函数
├── validator/ # 自定义参数校验器
├── web/ # 前端Dockerfile
│   ├── backend/ # 后台管理系统页面（Vue3）
│   └── frontend/ # 博客用户前台页面（Vue3）
└── worker/ # 异步任务处理模块（如邮件队列）

⚙️ 环境变量配置（.env.example）

ENVIRONMENT=development
ALLOWED_ORIGINS=http://localhost:3000,http://localhost:5173,http://localhost:80,...
DB_DRIVER=postgres
DB_USER=root
DB_PASSWORD=secret
DB_SOURCE=postgresql://root:[email protected]:5432/nostalgia?sslmode=disable
MIGRATION_URL=file://db/migration
RESOURCE_PATH=./resources
DOMAIN=http://localhost:8080
HTTP_SERVER_ADDRESS=0.0.0.0:8080
GRPC_GATEWAY_ADDRESS=0.0.0.0:9091
GRPC_SERVER_ADDRESS=0.0.0.0:9090
TOKEN_SYMMETRIC_KEY=...
ACCESS_TOKEN_DURATION=15m
REFRESH_TOKEN_DURATION=24h
REDIS_ADDRESS=redis:6379
EMAIL_SENDER_NAME=name
EMAIL_SENDER_ADDRESS=...
EMAIL_SENDER_PASSWORD=...
UPLOAD_FILE_SIZE_LIMIT=5242880
UPLOAD_FILE_ALLOWED_MIME=image/jpeg,image/png
HTTP_PROXY_ADDR=http://host.docker.internal:10808
DEFAULT_USER_ID=uuid
DEFAULT_USERNAME=username
DEFAULT_USER_PASSWORD=123456
DEFAULT_USER_FULLNAME=fullname
[email protected]

🚀 快速部署

确保你已安装 Docker 和 Docker Compose

1. 克隆项目

git clone https://github.com/MonitorAllen/nostalgia.git
cd nostalgia

2. 启动所有服务（API + Redis + PostgreSQL + Nginx + Vue 前端）

docker compose up --build

默认服务端口：

接口入口说明（本地docker环境）

🧪 本地开发

确保你已安装 Docker

1. 克隆项目

git clone https://github.com/MonitorAllen/nostalgia.git
cd nostalgia

Go API

make redis # 默认镜像为 redis:7-alpine，可在 Makefile 中自行调整
make postgres # 默认镜像为 groonga/pgroonga:3.2.3-alpine-16
make create_db # 创建数据库
make migrateup # 数据库迁移
make server # 启动 API 服务
or
make server_docker_up # 参考 Makefile

前端

前台

cd frontend
npm install
npm run dev

后台

cd backend
npm install
npm run dev

📮 联系与支持

如需反馈，可联系作者邮箱 [email protected] 或提交 Issue。