项目介绍

主题管理功能还在开发中！

Arks 是基于 Gin + GORM + MySQL + Vue + H5 + react + flutter 开发的个人博客系统，博客主要分为后台管理端和web展示端和app展示端。

• 各端均采用前后端分离的开发模式，通过 JSON 格式数据进行前后端交互。

功能特性

1. 文章

   • 编辑器采用 vditor，提升中文 markdown 使用体验
   • 文章标签、分类管理
   • 文章置顶
   • 文章加密
   • 自定义文章链接
   • 文章排序
   • 草稿箱和回收站
   • 从文件导入文章

2. 外观

   • 自定义菜单
   • 主题导入
   • 主题切换
   • 主题设置
   • 主题编辑

3. 评论

   • 回收站
   • 评论审核
   • 邮件通知

4. 图床

   • 支持 sm.ms，imgbb 和 腾讯云 cos 存储
   • 多图片上传
   • 图片管理

5. 页面

   • 日志管理
   • 自定义页面
   • 图库管理

6. 友情链接

   • 添加、修改友链
   • 友链分类

7. 用户

   • 修改用户信息
   • 修改密码

8. 设置

   • 网站设置
   • 邮件设置
   • 图床设置
   • 评论设置
   • 参数设置

如何在本地运行 Acks

• 运行环境：

  请确保已安装好以下环境，配置好 go mod 代理和 npm 国内镜像源

  • Go 1.15
  • Node.js v12+
  • MySQL 5.7+

  如何配置 go mod 代理：https://goproxy.io/zh/

  如何配置 npm 国内镜像源：https://www.cnblogs.com/luckyhui28/p/12268313.html

• 克隆项目代码到本地：

  git clone git@github.com:CVopen/arks.git
  https://github.com/CVopen/arks.git

• 新建名称为 ark 的数据库，注意字符集为 utf8m64，字符编码为 utf8m64_general_ci。

• 修改项目目录下 config/develop.yaml 配置文件中的数据库连接密码：

  # 服务器配置
  server:
    mode: "debug"                               # 运行模式
    port: "8088"                                # 端口
  # 数据库配置
  db:
    host: "127.0.0.1"       # 主机地址
    user_name: "root"       # 用户名
    password: "root"    # 密码
    database: "ark"       # 数据库名
    port: "3306"            # 端口
    time_zone: "Local"      # 时区
    max_idle_conn: 10       # 最大空闲连接数
    max_open_conn: 20       # 最大打开连接数

• 进入项目根目录，安装 gin 项目相关依赖：

  go mod download
  go get -u github.com/swaggo/swag/cmd/swag 

• 进入项目根目录，启动 gin 项目：

  go run main.go

• 在浏览器中访问 http://127.0.0.1:8888 可进入博客展示端。