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

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

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

快速上手

两条安装路径，效果一样，都能启动 Trader：

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 则把它封装成勾选框，最终都进入 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 才能生效。

进阶配置

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

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

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

下一步

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

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