TokenPort 部署指南

三步在电脑上运行 TokenPort

← 返回首页

第一步:安装 Node.js

TokenPort 基于 Node.js 运行,需要先安装 Node.js(v16 或以上版本)。

Windows
Windows
下载 .msi 安装包,一路下一步即可
macOS
macOS
下载 .pkg 安装包,或用 brew install node
Linux
Linux
使用 nvm 或包管理器安装

下载地址:https://nodejs.org

安装完成后,打开终端/命令提示符,输入 node -v 确认安装成功。

第二步:启动 TokenPort

在项目文件夹中,有以下两种方式启动:

方式一:一键启动(推荐)

./start.sh

脚本会自动检查环境、安装依赖、创建配置文件并启动服务。

方式二:手动启动

npm install cp .env.example .env npm start

首次启动后,打开浏览器访问 http://localhost:3000 即可。

第三步:安装到桌面/手机主屏

TokenPort 支持 PWA,可以像原生App一样安装到桌面和手机主屏。

电脑端(Chrome/Edge)

  1. 打开 http://localhost:3000
  2. 点击地址栏右侧的安装图标
  3. 点击「安装」,TokenPort 出现在桌面
  4. 双击桌面图标即可全屏使用,无需浏览器

手机端(同一WiFi下)

  1. 手机连接与电脑相同的 WiFi
  2. 手机浏览器打开 http://电脑IP:3000(如 http://192.168.1.100:3000)
  3. Safari:分享 -> 添加到主屏幕
  4. Chrome:菜单 -> 添加到主屏幕
  5. 从主屏幕打开,全屏原生App体验

查看电脑IP:Windows 输入 ipconfig,macOS 输入 ifconfig | grep inet

初始管理员账号

用户名: admin 密码: admin123456

首次登录会弹出安全提醒,要求强制修改密码。修改后才能进行管理操作。

配置文件说明

编辑 .env 文件可以修改以下配置:

手机访问电脑上的 TokenPort

  1. 确保手机和电脑连接同一WiFi
  2. 在电脑终端运行以下命令查看IP:
# Windows ipconfig # macOS / Linux ifconfig | grep "inet " | grep -v 127.0.0.1

找到类似 192.168.x.x 的地址,在手机浏览器输入:

http://192.168.x.x:3000

打开后可以「添加到主屏幕」,以后直接从手机桌面打开使用。