Stark

简单、灵活、可配置的导航网站

特性：

• 清爽的界面，给用户提供便捷的导航。
• 可配置的后台管理系统，给管理人员提供快速更新和修改的管理后台。
• 根据网址名称和简介的全局搜索。
• 针对单个用户的网址收藏，免登陆。
• 支持网站标题、导航语、页脚等配置项的动态管理。

---

快速开始：

强烈推荐!

直接去docker hub 拉取镜像跑容器
拉取镜像，启动容器：

docker run -p 8818:8080 -d felixglow/stark:V2.0

推荐：使用 Volume 挂载数据（数据持久化）

为了避免容器删除后数据丢失，建议挂载数据目录：

# 创建数据目录
mkdir -p ~/stark_data/db
mkdir -p ~/stark_data/media

# 启动容器并挂载数据
docker run -p 8818:8080 -d \
  --name stark \
  -v ~/stark_data/db:/stark/backend \
  -v ~/stark_data/media:/stark/backend/media \
  --restart unless-stopped \
  felixglow/stark:V2.0

这样做的好处：

• 数据保存在宿主机，容器删除后数据不丢失
• 方便备份和迁移
• 升级版本时只需更换镜像，数据自动保留

最后访问代理服务器 http://xxx.xxx.xxx.xx:8818 （部署服务器的公网IP加8818端口）就可以看到啦

访问后台管理系统，添加数据：http://xxx.xxx.xxx.xx:8818/admin/management/ 访问密码默认为：giant123

注意，docker方式部署直接用sqlite做数据库，数据量不大，为你省去配置数据库的麻烦。

从 V1.0 升级到 V2.0

如果你之前运行的是 V1.0 版本，请参考升级文档：V1.0 升级到 V2.0 指南

---

其他方式部署

Docker部署

1. 自己构建镜像

如果需要改动代码 改完代码，项目主目录构建镜像（前端代码需要编译，npm run build）

# 编译前端
cd frontend
npm run build
cd ..

# 构建镜像
docker build -t stark:V2.0 .

启动容器（推荐挂载数据）

docker run -p 8818:8080 -d \
  --name stark \
  -v ~/stark_data/db:/stark/backend \
  -v ~/stark_data/media:/stark/backend/media \
  stark:V2.0

与docker hub方式一样，同样访问 http://xxx.xxx.xxx.xx:8818

2. 直接部署

backend/settings路径中对应的环境配置，配置mysql连接。
初始化数据库表执行:

python manage.py migrate

初始化网站配置（可选）:

python manage.py init_footer_config

1. 后端在backend/路径下执行

python manage.py runserver

根据环境变量中ENV的值（test/dev/prod）然后取settings中对应的环境配置

2. 前端可以在frontend/config/env.js中配置proxy后端的地址，可以直接

npm run start:[test/dev/prod]

，或者npm run build编译后通过nginx做代理

nginx 代理示例

server {
    gzip on;
    gzip_min_length 1k;
    gzip_buffers 4 16k;
    gzip_http_version 1.0;
    gzip_comp_level 2;
    gzip_types text/plain application/x-javascript text/css application/xml application/javascript;
    gzip_vary on;


    listen       80;
    server_name  localhost;

    location / {
        root   /var/run/www;
        index  index.html index.htm;
        try_files $uri $uri/ /index.html;
    }

    location /api {
        proxy_pass http://192.168.1.1:8080;
        proxy_set_header   X-Forwarded-Proto $scheme;
        proxy_set_header   Host              $http_host;
        proxy_set_header   X-Real-IP         $remote_addr;
    }

    location /media/ {
        proxy_pass http://192.168.1.1:8080/media/;
    }

    location /static/ {
        proxy_pass http://192.168.1.1:8080/static/;
    }

    location /admin/ {
        proxy_pass http://192.168.1.1:8080/admin/;
    }
}

技术栈

1. 后端使用python，web框架使用django。
2. 前端react，使用ant-design的前端框架

相关文档

• V1.0 升级到 V2.0 指南 - 数据迁移和升级步骤
• Docker 部署详细文档 - 构建、发布、配置说明
• 网站配置功能 - 配置项说明

如何使用

管理员角色

数据模型分为三个

• 标签（网址类别）
• 卡片（网址信息）
• 卡片菜单 （网址的不同入口，如测试环境、生产环境等）

管理员通过http://部署的访问地址/admin/management/ （例如http://xxx.xxx.xxx.xx:8818/admin/management/ ）访问后台管理系统，添加数据。

注意：docker方式部署，后端访问密码默认为：giant123

网站配置管理
管理员可以在后台管理系统中配置网站信息，无需修改代码：

• 网站标题（浏览器标签页显示）
• 顶部标题（导航栏显示）
• 导航语（首页描述文字）
• 页脚链接和版权信息

配置路径：后台管理 → Config → Site configs

前台查看新增的网址信息

普通用户

1. 点击卡片下的菜单，进入该网址的对应入口。
2. 点击卡片右上角的五角星，就可以收藏到我的收藏☆中，以后可以直接从我的收藏快速找到你想经常访问的地址。（收藏数据保存在浏览器本地，不会丢失）
3. 右上角可根据网址名称和描述，全局搜索。