VeighNa 使用指南:从快速上手到策略加密,一次讲清 VeighNa Station 的完整用法

发布时间:2026/10/26 10:13:10
VeighNa 使用指南:从快速上手到策略加密,一次讲清 VeighNa Station 的完整用法

VeighNa 使用指南:从快速上手到策略加密,一次讲清 VeighNa Station 的完整用法

【免费下载链接】vnpy基于Python的开源量化交易平台开发框架项目地址: https://gitcode.com/vnpy/vnpy

VeighNa(vnpy)是基于 Python 的开源量化交易平台开发框架,而随 VeighNa Studio 一起安装的VeighNa Station是它的图形化入口,负责登录鉴权、拉起VeighNa Trader、管理投研环境和组件更新。这篇 VeighNa 快速上手指南带你走完"装好 → 登录启动 → 拉起 Trader → 回测投研 → 加密更新"的完整路线。

快速上手

两条安装路径,效果一样,都能启动 Trader:

方式操作适用人群
VeighNa Studio 发行版Windows 直接下载安装包日常使用,开箱即用
源码安装git clone 后运行安装脚本Linux / macOS、二次开发
  1. 下载 VeighNa Studio(内置 Python 3.10、框架与全部依赖)并安装;源码方式执行git clone https://gitcode.com/vnpy/vnpy,解压或进入仓库后依次运行bash install.sh安装。
  2. 安装完成后桌面出现 VeighNa Station 快捷方式,双击启动;首次运行先弹免责声明,点【确认】进入登录界面。
  3. 在 VeighNa 社区论坛注册账号后,输入论坛的账号密码完成登录,进入 Station 主界面。

注意:VeighNa Station 的登录账号是社区论坛的账号密码,不是 GitHub 或微信账号。

首次登录的三个坑

  • 注册时个人邮箱请如实填写,后续找回密码等论坛功能都依赖它。
  • 用户名自动取微信昵称,且不支持修改,注册前想清楚。
  • 密码请牢记,它与论坛密码通用,忘了只能走论坛找回流程。

登录界面只在首次运行时弹出,之后 Station 会自动登录直接进入主界面;想重置状态,走【系统】-【登出】即可,登出会同时关闭程序,下次启动重新要求登录。

看懂主界面:五大功能区

登录后的主界面分四块:顶部是【系统】和【帮助】菜单栏;左侧功能栏是社区、交易、投研、加密、更新五个入口;右侧主显示区随左侧选择切换内容;左下角还有【使用文档】【社区求助】两个按钮,下方一行是官方频道入口。

点击【社区】后,右侧直接内置展示官方论坛帖子,不用切浏览器就能查资料和回帖,新手期最常用。

一键拉起交易终端

前提:准备一个 CTP 仿真账号(在 SimNow 注册,同时记下经纪商代码和交易、行情服务器地址),之后在 Trader 里连接接口时使用。

操作:

  1. 点击左侧【交易】,右侧出现交易接口和应用模块勾选区,给需要的项打勾,例如 CTP 接口、CTA 策略、CTA 回测、数据管理模块;
  2. 点击主显示区左下角【启动】,Station 拉起VeighNa Trader,左下角输出区实时打印启动与运行日志;
  3. Trader 的窗口标题会附带当前运行目录,一眼确认程序实际使用的数据位置。

注意:Trader 运行期间不要关闭 Station,关闭后 Trader 会自动退出。

常见卡点:启动后左侧栏没看到回测图标,多半是勾选时漏掉了 CTA 回测模块,退出 Trader 重新勾选后再启动。

图形模式与脚本模式怎么选

同一个 Trader 有两条启动路径:

方式操作适用场景
图形模式Station 勾选接口与模块后点【启动】日常使用,零代码
脚本模式写 run.py 后执行python run.py二次开发、调试、自定义加载组合

两种方式的差异只在"加载哪些接口和应用"这一步:脚本里显式写出,Station 则把它封装成勾选框,最终都进入 vnpy/trader/ui/mainwindow.py 的MainWindow,拉起同一套 Trader 主界面。脚本模式的核心就几行:

from vnpy.event import EventEngine from vnpy.trader.engine import MainEngine from vnpy.trader.ui import MainWindow, create_qapp qapp = create_qapp() event_engine = EventEngine() main_engine = MainEngine(event_engine) main_engine.add_gateway(CtpGateway) main_engine.add_app(CtaStrategyApp) main_engine.add_app(CtaBacktesterApp) MainWindow(main_engine, event_engine).showMaximized() qapp.exec()

仓库里现成的 examples/veighna_trader/run.py 还列出了 CTP Mini、XTP、IB 等全部可选接口的注释示例,按需放开即可。

回测与投研:从数据到信号

前提:启动 Trader 时已勾选 CTA 回测模块,运行目录里已有回测所需的历史行情数据。

操作:在 Trader 左侧栏点 CtaBacktester 图标,界面上选策略、设参数区间、指定历史数据时间段,点开始后直接查看绩效报告。CTA 回测模块本身就设计为纯图形操作,不需要写 notebook。

预期结果:拿到策略回测绩效与参数优化结果,可以直接作为实盘参数参考。

常见卡点:回测报"数据缺失",通常是该时间段行情没入库,先用数据管理模块查库确认。

投研环境在 Station 里独立入口:点击【投研】,点【启动】后,Station 在右下角指定的运行目录拉起JupyterLab,之后的数据下载、因子研究、模型训练都在 notebook 里完成。仓库 examples/alpha_research 下的 notebook 可直接复制进该目录打开使用,比如download_data_rq.ipynb下载 A 股指数成分股数据、research_workflow_lgb.ipynb跑一套 LightGBM 投研流程。

策略加密与组件更新

前提:你要保护自己的策略是一个可独立运行的 .py 文件。

操作:

  1. 点击【加密】,再点【选择】,在弹出窗口选中策略文件并点【打开】,左下角输入栏会显示它的绝对路径;
  2. 点击【加密】,中央区域实时输出编译进度;
  3. 进程结束后,原位置生成一个 .pyd 文件。

注意:.pyd 文件名中的.cp310-win_amd64部分必须去掉,再放进运行目录下的strategies文件夹。之所以有这段后缀,是因为 Studio 内置 Python 3.10 64 位环境,编译产物会带上解释器平台标识;而 Trader 按"策略类名.py / 策略类名.pyd"的规则查找文件,带后缀的名字识别不了。

更新组件同样三步:点击【更新】→ 点【检查】列出本地已装模块及版本 → 点【更新】后台升级并输出进度。完成后点【OK】,重启 Station 才能生效。

进阶配置

以下配置不常用但影响面大,集中放在这里。

配置项位置说明
PyPI 索引【系统】-【配置】留空默认 pypi.org;私有镜像或内网 pypiserver 填对应地址
pip 代理【系统】-【配置】默认空;受限网络环境下组件更新依赖它拉包
数据库Trader 全局配置默认 SQLite 单文件 database.db,无需部署;可换 MySQL、PostgreSQL 等

组件更新本质是 pip 拉包升级,所以内网或代理环境必须先改好前两项,否则【更新】会失败。

另外,全局配置、日志、数据库文件都存放在运行目录的.vntrader文件夹里,其中vt_setting.json集中了字体、日志、邮件、数据服务与数据库参数。程序启动时优先使用当前工作目录下的.vntrader,找不到就回退到用户主目录,这套机制见 vnpy/trader/utility.py;在 Station 交易面板点【修改】切换运行目录,就能实现仿真与实盘两套环境的数据隔离。

下一步

VeighNa Station 把登录、启动交易、投研、加密、更新串成了完整日常链路,装好并拉起一次 Trader 之后,剩下的就是策略本身的打磨。接口连接、数据库配置和各应用模块的细节,接着查 docs 目录下的社区文档;卡住了去官方论坛【提问求助】板块发帖,一般很快有人回复。

【免费下载链接】vnpy基于Python的开源量化交易平台开发框架项目地址: https://gitcode.com/vnpy/vnpy

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考