基于 Golang 开源的网址导航网站项目,具备完整的前后台,您可以拿来制作自己平日收藏的网址导航。

• 图标库: lineicons
• 前端模板: WebStackPage
• 后端 Gin 框架: 基于 go-gin-api 项目二次开发

原有后端项目基础上新增功能:

• 新增 webstack - 导航首页
• 新增 系统管理员 - 网站分类
• 新增 系统管理员 - 网站列表
• 网站新增支持自动获取标题、Logo、网站描述、一键同步
• 新增 docker-compose.yml 一键安装各组件
• 批量添加网址
• 优化: 由 gorm-gen 代码生成提供支持的友好且更安全的 GORM

安装 Golang、Mysql、Redis

• Golang 1.16+ 因为使用了 //go:embed 特性;
• MySQL
  • 连接地址,例如:127.0.0.1:3306;
  • 数据库名,例如:webstack,会在此数据库下初始化数据表;
  • 用户名,不可为空;
  • 密码,不可为空;
• Redis
  • 连接地址,例如:127.0.0.1:6379;
  • 密码,可为空;
  • 连接DB,默认是 0 ;

两种方式运行 1. 源码启动服务 2. Docker启动服务

一、源码运行服务

1. 目录下执行 go mod tidy 拉取项目依赖库

2. 安装完依赖执行 go run main.go 首次启动程序之后,会在浏览器中自动打开安装界面,链接地址:http://127.0.0.1:9999/install

3. 点击 初始化项目 会看到如下图所示, 如果提示重新运行服务说明项目初始化完成, 只需重新运行服务就 OK 了!

二、Docker运行服务

包含两部分 1. 基础服务(Mysql、Redis、Service) 2. 监控服务(Prometheus、Grafana)

一、基础服务

1. 目录下执行 docker-compose -f docker-compose.yml up -d 等待基础组件启动 (Mysql、Redis、Service)

   $ docker-compose -f docker-compose.yml up -d
   [+] Running 4/4
   ✔ Network webstack-go Created 0.1s
   ✔ Container webstack-go-mysql Healthy 12.9s
   ✔ Container webstack-go-redis Healthy 13.4s
   ✔ Container webstack-go-service Started 

2. 执行docker-compose -f docker-compose.yml ps 服务正常运行如下

   NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
   webstack-go-mysql mysql/mysql-server:5.7 "/entrypoint.sh mysq..." webstack-go-mysql 2 minutes ago Up 2 minutes (healthy) 0.0.0.0:3306->3306/tcp, 33060/tcp
   webstack-go-redis redis:6.2.4 "docker-entrypoint.s..." webstack-go-redis 2 minutes ago Up 2 minutes (healthy) 0.0.0.0:6379->6379/tcp
   webstack-go-service webstack-go-webstack-go-service "./webstack-go -env ..." webstack-go-service 2 minutes ago Up 2 minutes (healthy) 0.0.0.0:9999->9999/tcp

3. docker container 正常运行后, 在浏览器中打开安装界面,链接地址:http://127.0.0.1:9999/install

4. 点击 初始化项目 会看到如下图所示, 如果提示重新运行服务说明项目初始化完成, 只需重新运行 webstack-go-service 容器服务就 OK 了!

二、prometheus、grafana监控服务

注: 监控服务看自己是否需要, 不运行也不影响正常使用

1. 目录下执行 docker-compose -f docker-compose-prometheus.yml up -d 等待监控组件启动 (Prometheus、Grafana)

   [+] Running 4/4
   ✔ Container webstack-go-prometheus Started 4.0s
   ✔ Container webstack-go-loki Started 3.6s
   ✔ Container webstack-go-grafana Started 4.3s
   ✔ Container webstack-go-promtail Started 

2. 执行docker-compose -f docker-compose-prometheus.yml ps 服务正常运行如下

    NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
    webstack-go-grafana grafana/grafana-enterprise:9.4.3 "/run.sh" webstack-go-grafana 2 minutes ago Up 2 minutes 0.0.0.0:3000->3000/tcp
    webstack-go-loki grafana/loki:2.7.3 "/usr/bin/loki -conf..." webstack-go-loki 2 minutes ago Up 2 minutes 0.0.0.0:3100->3100/tcp
    webstack-go-mysql mysql/mysql-server:5.7 "/entrypoint.sh mysq..." webstack-go-mysql 3 minutes ago Up 3 minutes (healthy) 0.0.0.0:3306->3306/tcp, 33060/tcp
    webstack-go-prometheus prom/prometheus:latest "/bin/prometheus --c..." webstack-go-prometheus 2 minutes ago Up 2 minutes 0.0.0.0:9090->9090/tcp
    webstack-go-promtail grafana/promtail:2.7.3 "/usr/bin/promtail -..." webstack-go-promtail 2 minutes ago Up 2 minutes 
    webstack-go-redis redis:6.2.4 "docker-entrypoint.s..." webstack-go-redis 3 minutes ago Up 3 minutes (healthy) 0.0.0.0:6379->6379/tcp
    webstack-go-service webstack-go-webstack-go-service "./webstack-go -env ..." webstack-go-service 3 minutes ago Up 3 minutes (healthy) 0.0.0.0:9999->9999/tcp

Star History Chart

首页

网站分类

新增网站

网站信息

监控组件

grafana.png