Dashboardv2 项目部署教程

前端准备

拿来一台电脑,安上下面这三件套

Node.js

打开浏览器,访问 https://nodejs.org/ 在首页找到"LTS"或"Current"版本下载链接,推荐选LTS版。 根据你的计算机操作系统选择相应的安装包,然后一路Next安装就好。 好了之后Win+r输入cmd打开命令行窗口

npm -v

出来东西就是完事了,比如我这样。

Microsoft Windows [版本 10.0.22635.3420]
(c) Microsoft Corporation。保留所有权利。

C:\Users\Administrator>npm -v
10.2.5

pnpm

打开命令行工具(在Windows下按 Win + R 键,输入 cmd 并回车;在Mac下,打开"终端"应用)。 Windows输入以下命令来全局安装pnpm:

npm install -g pnpm

如果需要管理员权限,在Unix/Linux/macOS下加上sudo

sudo npm install -g pnpm

git

首先,你需要访问Git的官方网站:https://git-scm.com/downloads 在下载页面,根据你的操作系统选择对应的Git版本。 下载完成后,找到下载的安装文件,双击它开始安装。 安装全部一遍过,一直NextAdjusting your PATH environment页面,选择Use Git from the Windows Command Prompt选项,这样你就可以在Windows命令提示符中使用Git命令。

接下来拉取仓库

 git clone https://github.com/shuakami/Dashboardv2.git

仓库拉取完成后,进入到项目的目录,使用pnpm安装项目的依赖:

cd Dashboardv2
pnpm install

安好之后就可以留着备用了,接下来来到后端。

后端准备

准备一台Linux/Windows服务器,具体哪家的无所谓,不过你要记住大陆服务器需要备案。接下来推荐你给服务器安装上宝塔面板。不安装的话,Linux服务器配置Nodejs请参考 这篇文章

宝塔面板安装后,按照新手指示安装套件。 安装完成后,点击侧边栏软件商店,在搜索栏输入PM2 选择PM2管理器安装。安装好后,按照图片所示,安装cnpmyarn

如果安装失败

如果上面安装失败,打开宝塔侧边栏终端选项 输入服务器密码登录,手动安装cnpm

npm install -g cnpm --registry=https://registry.npmmirror.com

然后再安装yarn

cnpm install -g yarn

接下来把Api的整合包下下来。来到 https://github.com/shuakami/Dashboardv2/tree/api ,把Api分支全部下下来。

提示

如果出现下载问题、或者你不会?请直接从下方三条分流选择下载

下载完成后,进行解压

你会得到一个api文件夹,和一个strapi_ALL_opensource_0.0.1_dashboardv2_shuakami.zip。 如果你已经在之前配置了strapi,你可以直接使用api文件夹,剩下的zip都可以删了。

反之,继续解压剩下那个zip。 注意,解压一定要加目录,不然会直接解压出来,处理很麻烦。

解压完毕后,打开目录,选择终端

cnpm install
cnpm run build
cnpm run develop

你看到能跑起来就ok了。接下来回到PM2 管理器新建一个项目: 这里的目录/api/strapi-server取决你把目录解压到哪里

启动文件
/www/wwwroot/api/strapi-server/server.js
运行目录
/www/wwwroot/api/strapi-server
项目名称  strapi-server
负载实例数量  1
内存上限  1024
运行用户   www

然后把你网站弄好就ok了,如果套CDN可以这样配置

| 类型 | 内容 | 策略 | 策略描述 | | --- | --- | --- | --- | --- | | 全部 | * | 按源站Cache-Control响应头缓存 | 缓存忽略参数 |
| 文件类型 | php,jsp,asp,aspx | 不缓存 | 跟随"全部" |
| 目录 | /admin | 不缓存 | 跟随"全部" |
| 文件类型 | .jpg:.png:.gif:.css:.js | 30天 | 缓存忽略参数 | | 目录 | /api | 不缓存 | 跟随"全部" |
| 首页 | / | 30天 | 跟随"全部" |


接下来访问你的绑定的域名,在域名后面加上/admin

举个例子: 比如我的域名是 abc.com 我就需要访问 abc.com/admin

进入后台,上方可以选择语言

使用默认账户进入

账号:shuakami@sdjz.wiki 密码:123456789cX

进入后台后,在设置-用户改你的邮箱用户名和密码

部署上线

接下来我们回到之前的前端部分

进入\apps\www目录 找到.env.example文件

复制.env.example里面的内容,新建一个.env粘贴进去。 按照复制的内容配置

# .env.example
# ========================================================
# 此文件作为环境变量模板,用于存储应用程序所需的敏感信息。
# 将此文件复制为'.env'并根据实际需求填写相应值。
# 切勿将包含实际密钥的'.env'文件提交到版本控制系统。
# ========================================================

# ==================================
# 部署说明
# ==================================
##   - 新建一个 `.env` 文件
##   - 将此 `.env.example` 文件的内容复制到名为 `.env` 的新文件中。
##   - 根据每个变量的说明,修改其值。
##   - 确保将 `.env` 文件添加到项目 `.gitignore` 中,防止意外提交。
##   - 如果是vercel部署,你可以直接在vercel上配置环境变量。
##   - 保持 API 密钥、令牌和其他敏感数据的机密性,永不公开分享或提交至版本控制系统。

# ==================================
# Strapi API 配置
# ==================================
# Strapi 后端服务器的URL# 将 'https://xn--7ovw36h.love' 替换为您的实际 Strapi 服务器地址。
NEXT_PUBLIC_STRAPI_URL=https://xn--7ovw36h.love

# ==================================
# OpenAI API 配置
# ==================================
# OpenAI API 端点的基础URL# 如与实际 OpenAI API 域名不同,请替换 'https://api.openai-hk.com'# 比如官方的 https://api.openai.com
# 我这不是打广告,是因为国内网络问题迫不得已!!
NEXT_PUBLIC_OPENAI_URL=https://api.openai-hk.com

# 用于向 OpenAI API 发送请求时进行身份验证的 OpenAI API 密钥。
# 通过 OpenAI Dashboard(https://openai.com/dashboard/keys)获取密钥。
# 如果你用的是 Openai-hk 那 https://www.openai-hk.com/v3/ai
# 将下面的秘钥替换为实际 API 密钥(如果你是用的官方 就是 sk-xx)
NEXT_PUBLIC_OPENAI_KEY=hk-xx

# ==================================
# 51La 网站统计配置 (可选)
# ==================================
# 51La 分配的网站统计跟踪ID# 在 51La 账户控制台找到或生成此 ID https://v6.51.la/user/application
# 在 51la 的安装代码部分可以看到id
# <script>LA.init({id:"3HelNpBlGrfK32c6",ck:"3HelNpBlGrfK32c6"})</script>
# 将 '3HelNpBlGrfK32c6' 替换为您的实际跟踪 IDNEXT_PUBLIC_LA_ID=3HelNpBlGrfK32c6

# ==================================
# reCAPTCHA 配置
# ==================================
# 用于客户端集成 reCAPTCHA 验证的 reCAPTCHA 公钥。
# 通过 Google reCAPTCHA 管理控制台(https://www.google.com/recaptcha/admin)获取密钥。
# 将 '6LcpUW4pAAAAAGMEM0quB2kUhtRpX5HWj9PolOcT' 替换为您的实际公钥。
NEXT_PUBLIC_RECAPTCHA_KEY=6LcpUW4pAAAAAGMEM0quB2kUhtRpX5HWj9PolOcT

# ==================================
# Matomo(piwik)分析配置 (可选)
# ==================================
# 先安装Matomo开源程序
# Matomo(原 Piwik)分析服务器的URL# 将 'analytics.sdjz.wiki' 替换为您的实际 Matomo 服务器地址。
# NEXT_PUBLIC_MATOMO_URL=analytics.sdjz.wiki

# Matomo 分配的用于追踪您网站统计信息的站点ID
# 在 Matomo 管理面板的"Sites"" Websites"部分找到此 ID# 将 '1' 替换为您的实际 Site ID# NEXT_PUBLIC_MATOMO_SITE_ID=1

然后你可以选择直接在本地看效果

pnpm dev

或者直接上线

pnpm install -g vercel
vercel login
vercel

详细教程可以看 这里

一般情况下,你可能需要到 vercel 后台代码添加项目环境配置


无论是pnpm dev还是vercel 配置好后都会要求登录。

这个时候,你可以去strapi后台修改你的账户

令牌AShaDi = 用户名 动态验证 = 密码

如果着急看效果

用户名:test(点不了按钮,但是你可以回车) 密码:123456