github Coooolfan/UniBoard 0.2.5
v0.2.5

4 days ago

v0.2.5

相较于v0.2.4

此版本主要用于测试Github工作流

chore: 添加Docker构建工作流

feat: 在仪表盘挂载时预加载子组件

部署与安装

Docker-compose

Note

对于WSL用户,请尝试直接在用户目录下创建文件夹运行,不要在/mnt文件夹中运行,compose中的postgres服务可能无法在此情况下设置文件权限

  1. 下载.env文件和docker-compsoe.yml文件

    mkdir uniboard
    cd uniboard
    wget https://github.com/Coooolfan/UniBoard/releases/download/v0.2.5/docker-compose.yml    
    wget https://github.com/Coooolfan/UniBoard/releases/download/v0.2.5/example.env
  2. 按照需要修改.env文件和docker-compsoe.yml

    1. docker-compsoe.yml:默认只暴露8888端口(文件第8行),通过此端口向外暴露所有服务,如果您需要对uniboard配置反向代理,只需代理此端口即可。

    2. .env:按照提示修改即可,切记要修改DJANGO_SUPERUSER_PASSWORD的值,不要使用默认值!

    3. 修改完成后复制example.env.env文件,供docker compose服务调取

      cp example.env .env
  3. 使用docker compose命令启动服务

    docker compose up -d
  4. 使用浏览器访问站点,默认为8888端口,如果您在本机部署,即访问http://localhost:8888即可

使用Nginx配置反向代理

Uniboard程序本身不提供ssl相关功能,直接暴露8888端口不是一个好的选择。

考虑到不同环境下Nginx的配置可能并不相同,下文仅提供思路和必要配置。

  1. 创建对应站点的conf文件

  2. 编辑监听的server_name, ssl相关内容

  3. 配置反向代理

    client_max_body_size 0; # 设置最大包大小为无上限
    location / {
        proxy_pass http://127.0.0.1:8888;
        proxy_set_header Host $host; # 保留代理之前的host
        proxy_set_header X-Real-IP $remote_addr; # 保留代理之前的真实客户端ip
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header HTTP_X_FORWARDED_FOR $remote_addr; # 在多级代理的情况下,记录每次代理之前的客户端真实ip
        proxy_set_header X-Forwarded-Proto $scheme; # 表示客户端真实的协议(http还是https)
        proxy_redirect default; # 指定修改被代理服务器返回的响应头中的location头域跟refresh头域数值
        proxy_buffering off;
    }
    

升级

本次升级无破坏性更新,手动编辑或者直接下载最新docker-compose.yml文件后重新运行即可 ↓

手动编辑docker-compose.yml文件

  1. 编辑docker-compose.yml文件第5行和第17行,将image字段最后一个:后的版本号改为最新版本即可。

  2. 重新启动服务

    # docker 会自动下载最新版本的镜像并启动服务
    docker compose up -d

重新下载docker-compose.yml文件

  1. 下载最新的docker-compose.yml文件

    wget https://github.com/Coooolfan/UniBoard/releases/download/v0.2.5/docker-compose.yml
  2. 按照需要修改docker-compose.yml文件

  3. 重新启动服务

    # docker 会自动下载最新版本的镜像并启动服务
    docker compose up -d

Full Changelog: v0.2.4...0.2.5

Don't miss a new UniBoard release

NewReleases is sending notifications on new releases.