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版本。
下载完成后,找到下载的安装文件,双击它开始安装。
安装全部一遍过,一直Next
在Adjusting 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管理器
安装。安装好后,按照图片所示,安装cnpm
和yarn
。
如果安装失败
如果上面安装失败,打开宝塔侧边栏终端
选项
输入服务器密码登录,手动安装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' 替换为您的实际跟踪 ID。
NEXT_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