自v0.4.0版本后我们将可以通/install/页面快速安装

  1. 环境搭建

    1. 系统环境

      我们推荐的生产环境为linux环境，我们的测试环境为 Debian 12 +宝塔11.6.0+python 3.13.x。

      我们使用的开发环境为win11+vscode+python 3.13.x

    2. 虚拟环境

      我们推荐使用虚拟环境进行运行，在win中可以使用venv,在宝塔面板当中，可以使用python项目--Python环境管理--创建虚拟环境

      前题条件是需要安装适合版本的Python，目前是我们支持3.13+

       

  2. 文件安置

    从官网获取代码的zip包后，你可以直接在服务器的www/wwwroot/下建新目录，将Djacore_cms.ZIP在新目录下解压

  3. 建立项目

    在宝塔python页面当中可以选择新建项目

    先选择uwsgi，然后将所有的须填写的地方按图所示进行填写。

    djacore虚拟环境可以复用，如果是该环境首次使用须安装依赖包，如果不是首次使用依赖包这里为空可实现网站秒建

     

  4. 网站安装

    建立好环境后，我们在项目设置中，绑定域名，开启外网。

    1. 绑定域名

    2. 开启外网

      如果我们设置的端口对应的外网映射为“未配置”，则我们点击开启

     

     

  5. 界面安装

    我们使用刚才绑定的域名/install/路径进行安装。

    在这里我们兼容了之前的版本和现在的版本，如果你是新装，那么我们则可以选择全新安装，如果为已经上线的项目，我们则只需要点击升级现有系统然后点击开始升级系统，系统会自动补充差异文件，完成安装。

    新项目我们则点击全新安装

    系统当中原有一个默认的链接文件connection_strings.yaml，此时显示的配置为默认的参数，我们需要按我们的数据配置进行填写，实测主机地址写127.0.0.1比写host更好。

    如果确定配置文件中的配置为正确配置，数据库密码可为空提交。然后直接点击测试连接并继续，

    设置完成后我们点击测试并继续。

    然后页面会等待系统保存配置并加载进系统。

    数据迁移：点击开始迁移按钮，系统将自动创建数据库表结构

    系统初始化：点击执行系统初始化，初始化系统核心配置，包括：密钥生成和轮换；目录权限检查；限制词库初始化；单例模型初始化。

    收集静态文件：收集所有静态文件到指定目录，用于生产环境。

    建立管理员账号：如果显示用户名 "admin" 已存在  那就说明我们初始化已经建立了一个默认的账号

    id:admin
密码：admin888

    然后选择创建管理员账号，系统会跳动跳转到后台的登陆页面

     

  6. 后续配置

    1. 静态与反代

      location /static/来配置静态文件的指向，静态文件不需要经过系统处理直接返回前端，速度、安全都是非常棒的

      反向代理 在宝塔11.6.0当中大家可以对比配置差别进行补充

      主要为

      proxy_set_header X-Forwarded-Proto $scheme; #原来没有则添加
proxy_set_header X-Forwarded-Ssl on;
proxy_set_header Host $host;#确认这个值，用ip+端口号容易出错。

       

      完整相关配置如下

      # 配置Djancore CMS静态文件
location /static/ {
    alias /www/wwwroot/djacorecms/collected_static/;
    }
# HTTP反向代理相关配置开始 >>>
    location ~ /purge(.*) {
        proxy_cache_purge cache_one 127.0.0.1$request_uri$is_args$args;
    }

    # proxy
    location / {
        proxy_pass http://127.0.0.1:8013;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Ssl on;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header REMOTE-HOST $remote_addr;
        add_header X-Cache $upstream_cache_status;
        proxy_set_header X-Host $host:$server_port;
        proxy_set_header X-Scheme $scheme;
        proxy_connect_timeout 30s;
        proxy_read_timeout 86400s;
        proxy_send_timeout 30s;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    # HTTP反向代理相关配置结束 <<<

  7. 安装完成

    此时你就可以通过在admin中设置所需要的配置，完善网站的各项功能