🚀 如何开始?
以下所有相关操作都基于项目根目录位置,请注意检查不要出错!
注意事项
- pnpm version >= 8
代码登录后可见
- Node.js version >= v20
- Postgres version >= 8.0.0
- Redis version >= 5.0.0
- 项目依赖 Docker,所以请确保你本地已安装并成功运行
编辑器
VSCode
代码登录后可见
1. 安装依赖
代码登录后可见
可以选择将 代码登录后可见 文件内容复制到 代码登录后可见,请注意 代码登录后可见 文件中的是示例配置,主要是一些系统的环境变量信息,比如:数据库连接地址、用户名、密码、端口、密钥等等,后端服务会从此文件中读取配置信息,当然你也可以更改成你自己的配置信息。
Windows 用户推荐快捷键复制粘贴,Linux 用户可以通过下面的命令进行操作。
Server
代码登录后可见
Client
代码登录后可见
3. 恢复 Logto 的数据
解压缩 代码登录后可见 到 代码登录后可见
代码登录后可见
- 后台地址: [链接登录后可见]
- 用户名: admin
- 密码: wYJha:-eYMrAe9i
4. 启动 Docker Compose 服务
后端用到了 Postgres 和 Redis 服务,通过下面在 代码登录后可见 中配置的命令启动和停止。
代码登录后可见
当然如果你更喜欢手动操作
代码登录后可见
5. 初始化数据库表结构
执行这个命令时,尽量与上个命令间隔一点时间,因为刚刚使用的 代码登录后可见 参数会让其服务挂起在后台执行,此时 docker 服务可能还在 running 中,若是发现报错了那就再执行一遍。
隔一点时间,因为刚刚使用的 代码登录后可见 参数会让其服务挂起在后台执行,此时 docker 服务可能还在 running 中,若是发现报错了那就再执行一遍。
代码登录后可见
6. 创建并上传课程数据
只有第一次初始化数据库后需要执行。
代码登录后可见
7. 启动后端服务
代码登录后可见
8. 启动前端服务
代码登录后可见
❓ 常见问题解答
数据库连接不上
我的 Docker 和里面的数据库都正常跑起来了,但是跑 代码登录后可见 命令时还是报错,提示数据库连接失败。
可以检查下 代码登录后可见 文件中的数据库配置是否正确,甚至是这个文件有没有!
如何正确的更新课程数据?
当你发现有错误的课程数据并修改后,应当使用下面的命令将课程数据更新到数据库中。
代码登录后可见
pnpm install 报错?
某些依赖模块需要编译安装,因此需要相关编译环境。如果没有对应环境则会编译失败, 且不同模块所需编译环境不同,因此具体问题需要具体分析。 以下列出已经碰到过的具体问题。
先尝试使用下面的命令更新 代码登录后可见。
代码登录后可见
在 Windows 上安装 argon2 模块失败的处理方式
- 安装 Visual Studio 2015 以上版本的组件,具体来说是 “使用 C++的桌面开发” 这个组件。(实际上包含 C++相关开发工具库的组件都可以)
- 编译过程中遇到中文乱码时,在命令行中执行 代码登录后可见 后,再重新运行 install 命令。
WSL2 中 docker 无权访问?
在 Windows 中使用 wsl2 做为开发环境时,通过 代码登录后可见 启动 docker 出现如下错误:
代码登录后可见
将当前的用户添加到 docker 组中
代码登录后可见
反向代理
参考教程:[链接登录后可见]
⚠️Nginx Proxy Manager(以下简称NPM)会用到80、443端口,所以本机不能占用(比如原来就有Nginx)
互联网使用请确保完成了域名解析