A personal blog system built with Spring Boot + MyBatis, featuring AI-powered content assistance, Redis caching, and a clean admin dashboard.
English | ็ฎไฝไธญๆ
- Smart Summary - Auto-generate article summaries via AI
- Tag Suggestions - AI-recommended tags based on content
- Article Scoring - Quality assessment with improvement suggestions
- Smart Search - Keyword extraction and related article recommendations
- Rich Editor - Markdown editor with live preview
- Draft System - Save unpublished articles as drafts
- Category & Tags - Flexible content organization
- Friend Links - Blogroll management
- Comment System - Valine-based serverless comments
- Message Board - Visitor guestbook
- Statistics Overview - Article count, views, tags, categories at a glance
- AI Status Monitor - Check AI service availability from dashboard
- Quick Actions - One-click shortcuts for common operations
- Recent Articles - Latest published posts table
- Redis Caching - Accelerated page loading
- Database Indexing - Optimized query performance
- HikariCP - High-performance connection pool
- BCrypt Encryption - Secure password hashing (Spring Security Crypto)
- SQL Injection Protection - MyBatis parameterized queries
- Login Interceptor - Admin route protection
- Input Validation - Bean Validation (JSR-380)
- SEO Optimization - Sitemap generation, meta tags, structured data
- Markdown Support - CommonMark parser with GFM tables and heading anchors
- Exception Monitoring - WeChat Work webhook notifications for system errors
- Global Exception Handling - Custom error pages with detailed logging
- AOP Logging - Request/response logging with aspect-oriented programming
- Scheduled Tasks - Automatic cache refresh and maintenance
| Layer | Technology |
|---|---|
| Framework | Spring Boot 2.7.x |
| ORM | MyBatis |
| Database | MySQL 8.0 |
| Cache | Redis |
| Template Engine | Thymeleaf |
| Pagination | PageHelper |
| Password Encryption | BCrypt |
| Connection Pool | HikariCP |
- JDK 8+ (tested with JDK 21)
- MySQL 5.7+ (recommended MySQL 8.0)
- Redis 5.0+
- Maven 3.6+
- Clone the repository
git clone https://github.com/tangredtea/Spring-Blog.git
cd Spring-Blog- Initialize the database
mysql -u root -p < blog.sql- Configure environment variables (recommended)
export DB_USERNAME=root
export DB_PASSWORD=your_password
export REDIS_PASSWORD=your_redis_password # if applicable
export AI_API_KEY=your_openai_api_key # optional, for AI features- Run the application
mvn spring-boot:run- Access the application
- Frontend: http://localhost:8080
- Admin panel: http://localhost:8080/admin
- Default credentials:
admin/admin123
# 1. Copy config
cp .env.example .env
# 2. Edit config
vim .env
# 3. Start all services
docker-compose up -dSpring-Blog/
โโโ src/main/java/com/blog/
โ โโโ controller/ # Controllers (admin + frontend + common)
โ โ โโโ admin/ # Admin panel controllers
โ โ โโโ blog/ # Frontend blog controllers
โ โ โโโ common/ # Common controllers
โ โ โโโ SitemapController.java # SEO sitemap
โ โโโ service/ # Business logic & AI services
โ โ โโโ impl/ # Service implementations
โ โโโ dao/ # Data access layer (MyBatis mappers)
โ โโโ entity/ # Entity classes (Blog, User, Tag, etc.)
โ โโโ pojo/ # Plain Old Java Objects (DTOs)
โ โโโ config/ # Configuration (Redis, WebMvc, Settings)
โ โโโ interceptor/ # Login interceptor
โ โโโ aspect/ # AOP logging
โ โโโ scheduled/ # Scheduled tasks (cache refresh)
โ โโโ exception/ # Global exception handling
โ โโโ enums/ # Enumerations (BlogStatus, etc.)
โ โโโ util/ # Utilities (Password, SEO, Markdown, etc.)
โโโ src/main/resources/
โ โโโ mapper/ # MyBatis XML mappers
โ โโโ templates/ # Thymeleaf templates
โ โ โโโ admin/ # Admin panel pages
โ โ โโโ fragments/ # Reusable fragments
โ โ โโโ error/ # Error pages (404, 500)
โ โโโ static/ # Static resources (CSS/JS/images)
โ โ โโโ css/ # Stylesheets
โ โ โโโ js/ # JavaScript files
โ โ โโโ images/ # Images
โ โ โโโ fonts/ # Web fonts
โ โ โโโ lib/ # Third-party libraries
โ โโโ application.yml # Main configuration
โ โโโ application-dev.yml # Development config
โ โโโ application-pro.yml # Production config
โ โโโ messages.properties # i18n messages
โโโ src/test/ # Unit tests
โโโ blog.sql # Database schema & seed data
โโโ Dockerfile # Docker build
โโโ docker-compose.yml # Docker Compose
โโโ nginx.conf # Nginx configuration
โโโ .env.example # Environment variables template
AI features are optional. To enable them, set the following in application-dev.yml or via environment variables:
ai:
api:
key: ${AI_API_KEY:} # OpenAI API key
url: ${AI_API_URL:https://api.openai.com/v1/chat/completions}
model: ${AI_MODEL:gpt-3.5-turbo}When AI is not configured, the system gracefully falls back to default behavior (no errors).
Edit src/main/resources/messages.properties to customize your blog:
# Basic Info
web_Name=Your Blog Name
web_Description=Your blog description
web_Keywords=Java Blog, Tech Blog
# Social Links
web_Github=https://github.com/yourusername
web_Csdn=https://blog.csdn.net/yourusername
# Comment System (Valine)
valine_AppID=your_leancloud_appid
valine_AppKey=your_leancloud_appkey
# WeChat Work Webhook (Optional - for error notifications)
wx_Webhook=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=your_key
# Set to "0" to disable webhook notificationsContributions are welcome! Feel free to open issues and pull requests.
- Fork the repository
- Create your branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Apache License 2.0 - tangredtea