adegtyarev/zipline

Zipline镜像集合

镜像概述

本镜像集合提供运行Zipline算法交易库的多种环境，基于Alpine Linux，支持Python 2.7和3.5。包含基础版、集成TA-lib的版本、开发版以及带Jupyter的研究版，满足不同场景的算法交易开发与研究需求。

核心功能

• 基础镜像：内置Zipline算法交易库
• TA-lib版（镜像标签：talib）：集成Zipline与TA-lib技术分析库
• 开发版（镜像标签：dev）：适用于Zipline开发的环境
• Jupyter版（镜像标签：jupyter）：集成Zipline与Jupyter Notebook，支持算法交易研究

使用场景

1. 命令行工具：替代本地Zipline命令，在Docker环境中执行算法交易相关操作
2. 研究笔记本：通过Jupyter Notebook进行算法策略开发与回测
3. 安全研究环境：使用HTTPS保护Jupyter笔记本访问
4. 基础镜像：作为构建Zipline相关工具的基础镜像

配置说明

快速开始

创建存储永久数据的卷（对应$ZIPLINE_ROOT）：

bash
docker volume create --name zipline-root

运行Zipline命令：

bash
docker run --rm --volume zipline-root:/zipline docker.xuanyuan.run/adegtyarev/zipline

命令行工具使用

将镜像作为Zipline命令的替代：

bash
export ZIPLINE_CMD="docker run --rm -t -v zipline:/zipline adegtyarev/zipline zipline"

使用该命令执行操作，例如摄入数据：

bash
$ZIPLINE_CMD ingest -b quantopian-quandl

运行示例策略：

bash
$ZIPLINE_CMD run -s 2017-1-1 -e 2018-1-1 -b quantopian-quandl -f zipline/examples/buy_and_hold.py

Jupyter研究笔记本（HTTP）

创建存储笔记本的卷：

bash
docker volume create --name zipline-notes

启动Jupyter服务器：

bash
docker run --rm -p 80:8888 \
    -v zipline-root:/zipline \
    -v zipline-notes:/notes \
    docker.xuanyuan.run/adegtyarev/zipline:jupyter

通过浏览器访问端口80即可使用。

Jupyter研究笔记本（HTTPS）

1. 创建存储证书的卷：

bash
docker volume create --name zipline-certs

2. 初始化证书卷权限：

bash
docker run --rm -v zipline-certs:/etc/letsencrypt docker.xuanyuan.run/adegtyarev/zipline:jupyter true

3. 获取Let's Encrypt证书（替换SSL_HOSTNAME和SSL_EMAIL）：

bash
SSL_HOSTNAME=example.com
SSL_EMAIL=your@email.com
docker run --rm -p 80:80 \
    -v zipline-certs:/etc/letsencrypt \
    docker.xuanyuan.run/certbot/certbot certonly --standalone \
    -d $SSL_HOSTNAME --agree-tos -m $SSL_EMAIL --non-interactive

4. 启动HTTPS版Jupyter：

bash
docker run --rm -p 443:8888 \
    -e SSL_HOSTNAME=$SSL_HOSTNAME \
    -v zipline-root:/zipline \
    -v zipline-notes:/notes \
    -v zipline-certs:/etc/letsencrypt \
    docker.xuanyuan.run/adegtyarev/zipline:jupyter notebook-ssl

通过浏览器访问端口443即可使用安全的Jupyter环境。

作为基础镜像

可将本镜像作为基础镜像构建Zipline相关工具：

Dockerfile
FROM adegtyarev/zipline:latest

COPY --chown=zipline:zipline . /src/zipline-cool-feature

RUN cd /src/zipline-cool-feature && \
    pip3 install \
        --no-cache-dir \
        --user \
        -r requirements.txt && \
    pip3 install \
        --no-cache-dir \
        --user \
        --editable \
        .