# 快速开始

# 环境准备

# 环境要求

硬件最低配置

CPU: 2核
内存: 4G
磁盘: 10G
网络: 100Mbps

软件包依赖

JDK 21

# 环境脚本安装

执行对应的环境安装脚本,自动安装环境依赖。

# Linux环境

curl https://gitee.com/dromara/northstar/raw/master/env.sh | sh

# Windows环境

打开 powershell 命令行环境,输入以下命令:

Invoke-WebRequest https://gitee.com/dromara/northstar/raw/master/env.ps1 -OutFile env.ps1; powershell -noexit ".\env.ps1"

假如执行报错,需要把脚本下载到本地后右键选择powershell执行。

# 安装后的路径说明

在Linux环境下,根目录是 ~/
在Windows环境下,根目录是 c:/

.
├─ northstar-dist                               程序包目录
└─ northstar-env                                环境依赖包目录

# 软件包下载

程序包在知识星球中分享 星球海报

下载解压后,放置到上述 northstar-dist 目录
最终的目录结构如下:

.
├─ northstar-dist                               程序包目录
|   ├─ northstar-<version>.jar                  主程序包
|   ├─ northstar-external-<version>.jar         策略包(非必需)
|   ├─ northstar-gateway-xxx-<version>.jar      实盘网关包(非必需)
└─ northstar-env                                环境依赖包目录

策略包是自行实现,具体可参考知识星球里的策略教程专栏

以下是实盘网关包地址(注意看版本说明):

# 程序启动

使用 java -jar 便可以启动程序

java -jar "-Dloader.path=$(pwd)" -Denv=prod northstar-<版本号>.jar

注意:

  • 要加上环境参数 -Denv=prod
  • 要指定外置依赖路径 "-Dloader.path=$(pwd)" $(pwd)是用于输出当前路径的命令。注意引号
  • 版本号按实际填,例如 northstar-8.0.0.jar
  • 若使用windows系统,以上命令必须用 powershell 执行,切勿用 cmd 命令行窗口

启动后,通过浏览器访问。

  • 若在本地启动,访问 https://localhost/
  • 若在服务器启动,访问 https://你的服务器IP/

启动成功后的界面 pro版登录页

注意:

Pro版只能用浏览器打开,社区版的桌面端并不适用

# 日志查询

可以在以下路径找到程序运行日志:

.
├─ northstar-dist   程序包目录
|   ├─ logs         程序日志目录
|   ├─ data         数据文件目录
└─ northstar-env    环境依赖包目录

# 设置数据服务权限

程序在初始状态下,是没有任何历史数据的。

在以下场景下,程序需要用到历史数据:

  • 历史回放
  • 行情复盘
  • 自动化交易

历史数据权限按市场划分,分别为:

  • 国内期货
  • A股
  • 港股
  • 美股
  • 币圈
  • 外汇黄金

# 免费试用

加入知识星球可获得一个月的试用权限。

# 付费使用说明

在付费后,用户可以拿到一串数据服务token,然后按以下方式设置即可。

# WINDOWS环境下

按下组合功能键 win + R,输入powershell,然后确定 此时会打开了一个命令行界面,执行

setx NS_DS_SECRET <数据服务token>

注意:

配置完成后,重启电脑才能生效

# LINUX环境下

执行

vim ~/.bashrc

在文末加入以下设置

...
export NS_DS_SECRET=<数据服务token>

保存并退出,然后让配置生效

source ~/.bashrc

使用过程中有任何问题,欢迎在群里提问

# 更多视频教程

可搜索微信视频号:盈富量化