65 lines
2.2 KiB
Markdown
65 lines
2.2 KiB
Markdown
# NanoKVM 前端页面
|
||
|
||
NanoKVM 前端页面的代码。更多文档请参考 [Wiki](https://wiki.sipeed.com/nanokvm) 。
|
||
|
||
## 目录结构
|
||
|
||
```shell
|
||
src
|
||
├── api // 后端接口
|
||
├── assets // 资源文件
|
||
├── components // 公共组件
|
||
├── i18n // 多语言
|
||
├── jotai // 全局 jotai 变量
|
||
├── lib // lib
|
||
├── pages // 页面
|
||
│ ├── auth // 鉴权页面
|
||
│ ├── desktop // 远程桌面
|
||
│ └── terminal // 终端
|
||
├── router.tsx // 路由
|
||
└── types // 类型定义
|
||
```
|
||
|
||
## 本地开发
|
||
|
||
> 开发需要启用 SSH 功能。请在 Web `设置 - SSH` 中检查 SSH 是否已经启用。
|
||
|
||
由于 CORS 的限制，在本地开发时，需要关闭鉴权功能。
|
||
|
||
如果想要开发鉴权相关的功能，需要编译后在 NanoKVM 中进行测试。
|
||
|
||
1. 通过 SSH 登录到 NanoKVM：`ssh root@your-nanokvm-ip`（默认密码为 root）；
|
||
2. 修改配置文件 `/etc/kvm/server.yaml`，添加一行 `authentication: disable`。⚠️注意：该选项会禁用所有鉴权功能，生产环境请勿开启该选项！
|
||
3. 执行 `/etc/init.d/S95nanokvm restart` 重启服务。
|
||
4. 编辑 `.env.development` 文件，将 `VITE_SERVER_IP` 修改为你的 NanoKVM IP 地址。
|
||
5. 执行 `pnpm dev` 启动服务，然后在浏览器中访问 http://localhost:3001/ 。
|
||
|
||
|
||
建议在浏览器中禁用缓存，防止在开发过程中出现无法访问的情况。
|
||
|
||
1. 打开开发者工具；
|
||
2. 点击 `Network` 选项卡；
|
||
3. 勾选 `Disable cache` 选项；
|
||
4. 刷新页面。
|
||
|
||
## 部署
|
||
|
||
编译：
|
||
|
||
```shell
|
||
cd web
|
||
pnpm install
|
||
pnpm build
|
||
```
|
||
|
||
1. 编译完成后会生成 `dist` 文件夹；
|
||
2. 将该文件夹重命名为 `web`；
|
||
3. 将 `web` 文件夹上传到 NanoKVM 的 `/kvmapp/server/` 目录下；
|
||
4. 在 NanoKVM 中执行 `/etc/init.d/S95nanokvm restart` 重启服务。
|
||
|
||
|
||
注意：
|
||
|
||
1. 上传文件需要启用 SSH 功能。请在 Web `设置 - SSH` 中检查 SSH 是否已经启用。
|
||
2. 更新 web 目录后，浏览器可能会有缓存。如果遇到打不开页面的情况，请强制刷新或清空缓存。
|