用户指南 | 优宽量化

托管者

优宽量化交易平台的托管者软件是整个量化交易系统的核心组件。托管者可以理解为您交易策略的执行引擎，负责处理复杂的数据请求、数据接收、网络连接、日志回传等任务。实盘策略程序运行在托管者软件上，而非运行在优宽量化交易平台网站上。

托管者运行在您的服务器上，即使优宽量化交易平台网站出现网络故障也不会影响托管者的正常运行。托管者支持在Linux、Windows、Mac OS、android、树莓派 ARM Linux等系统上运行。托管者管理的实盘日志均保存在托管者程序所在目录的./logs/storage路径下，以db3格式的Sqlite数据库文件存储。您可以使用Sqlite管理软件直接编辑这些文件。对于这些扩展名为db3的实盘数据库文件，文件名即为实盘的Id。

部署托管者

在托管者管理页面可以查看当前优宽量化交易平台账号部署关联的托管者，支持列表展示或详细信息展示两种模式。在此页面可以查询托管者的IP地址、版本、编译发布时间等相关信息。点击部署托管者按钮可跳转至托管者部署页面。托管者部署分为两种模式：1、一键租用托管者；2、手动部署托管者。

托管者部署页面

一键租用托管者

在托管者部署页面点击一键租用托管者标签，根据配置、服务器机房地区等需求选择需要部署的服务器。

点击「立即购买」并输入当前优宽量化交易平台的账号密码进行验证，验证通过后将自动进行托管者程序部署。整个部署过程需要几分钟时间，系统会自动安装常用的Python库。

点击「立即购买」后租用的服务器由于是通过平台代为租用，仅具有有限的系统权限，不支持远程登录。如需使用未预装的第三方Python库，建议使用私有服务器进行手动部署。

通过一键租用托管者功能租用的服务器采用独立计费方式，与实盘计费相互独立。

点击「重新部署」按钮不会删除托管者目录下logs目录中的实盘日志和数据文件。

手动部署托管者

您可以将托管者部署到各种设备上，例如：个人电脑、服务器、树莓派等，支持多种主流操作系统。

Linux 命令行版本：Linux AMD64 / Linux 386 / Linux ARM64 / Linux ARMv7
Mac 命令行版本：Mac Intel64 / Apple Silicon
Windows 命令行版本、界面版本：64位 / 32位
Docker 镜像

登录需要部署托管者程序的设备后，根据设备的操作系统下载对应的托管者程序。下载链接可以在托管者部署页面点击手动部署托管者标签后显示的内容中找到。
部署托管者程序需要设置2个参数：

手动部署托管者页面

1、包含优宽量化交易平台UID的通信地址。
2、UID对应的优宽量化交易平台账号的密码。

部署托管者时配置「通信地址」和「优宽量化交易平台账号密码」：

Windows界面版托管者
Windows界面版托管者可以直接将这两个参数填写到托管者界面上对应的输入框控件中。
命令行版托管者
对于其他命令行版托管者程序，不同的操作系统有不同的指令。以Linux & Mac为例，使用命令：./robot -s node.youquant.com/123456 -p 654321，以下说明命令中的各个部分：

./robot表示运行robot这个可执行程序（即托管者程序），其中123456为UID，654321为UID对应的优宽量化交易平台账户的密码。
-s参数表示「优宽量化交易平台UID的通信地址」，参数值可以填写例如：node.youquant.com/123456。
-p参数表示「UID对应的优宽量化交易平台账号的密码」，参数值可以填写例如：654321。

请注意这里的参数仅为示例，实际参数可以登录https://www.youquant.com后，在托管者部署页面点击手动部署托管者标签后查看。
-p参数并非必须明文写在部署托管者的命令中，可以使用./robot -s node.youquant.com/123456命令运行，然后会提示输入密码，再手动输入密码即可。
另外请注意执行程序的权限等问题，需要给予托管者程序足够的权限，解除运行限制。

托管者操作注意事项

重要操作提示

错误操作：
请勿直接在服务器等设备上强制停止托管者进程（如直接终止进程或重启服务器）。此类操作可能导致托管者与优宽平台失联，引发以下问题：
- 实盘无法正常停止
- 实盘持续运行并计费
  出现此类情况，需要先删除已离线的托管者，才能停止实盘。
正确操作流程：
- 确认托管者上没有任何运行中的实盘
- 再执行删除托管者或停止托管者进程的操作
  操作原则：先停实盘，再停托管者。

全局指定IP地址

Windows系统的界面版托管者可以直接在托管者软件界面上设置IP地址，托管者软件默认为自动设置IP。

命令行环境下运行的托管者使用-I参数指定IP地址。


            
            
            
-I string
    custom local ip address
-c string
    config file
-d string
    custom dns resolve server
-e string
    docker node executable path
-f string
    docker settings json
-i string
    docker image name
-n string
    node name
-p string
    password
-s string
    server address
-u string
    run as system user
-v  version info
-vv
    show verbose log
-w string
    working directory

命令行版本托管者程序的参数

下载托管者软件后，解压缩得到的可执行文件robot即为托管者程序，在部署托管者时可以为托管者程序指定参数。

-v：
查看当前托管者程序的版本、编译时间等信息。完整的执行命令以苹果电脑Mac系统为例：./robot -v。
-vv：
托管者程序的运行详细日志和交互消息，默认不显示且不写入托管者日志文件。这样可以防止频繁的交互指令导致日志记录膨胀并占用硬盘空间。如果您需要记录托管者的详细日志并在托管者运行时显示出来，可以通过使用-vv参数来设置详细日志和交互消息写入托管者日志文件。
-s：
运行托管者程序时指定与优宽量化交易平台通信的地址。完整的执行命令以苹果电脑Mac系统为例：./robot -s node.youquant.com/xxxxxxx，xxxxxxx部分为每个优宽量化交易平台账号的唯一识别ID，命令执行后会提示要求输入对应的优宽量化交易平台账号密码。
-p：
可以直接在运行命令中通过参数指定密码，不建议这样做，因为会在当前系统记录中留下密码参数。假设地址node.youquant.com/xxxxxxx对应的账号密码为：abc123456。完整的执行命令以苹果电脑Mac系统为例：./robot -s node.youquant.com/xxxxxxx -p abc123456。
-n：
为运行的托管者程序添加标签信息。完整的执行命令以苹果电脑Mac系统为例：./robot -n macTest -s node.youquant.com/xxxxxxx。在平台托管者管理页面的托管者信息中会显示macTest文本标记。
-l：
打印当前托管者支持的交易所列表。完整的执行命令以苹果电脑Mac系统为例：./robot -l。即可输出所支持的交易所名称。

实盘数据迁移

当需要将实盘数据迁移到其他设备（服务器）上的托管者时，可以将实盘的数据库文件（扩展名为db3的数据库文件）移动到目标设备（服务器）上托管者目录中的对应路径位置。将文件名设置为平台上对应的实盘ID，这样之前实盘的所有日志信息就不会因为迁移到新设备而丢失。

托管者监控

托管者管理页面，在托管者列表操作项或托管者详情操作项中可以开启托管者监控功能。开启监控后，如果托管者异常离线，绑定的邮箱将收到告警通知。