achannarasappa/ticker

终端***行情工具镜像文档

镜像概述

本Docker镜像提供一个终端环境下的行情工具，旨在通过命令行界面实时展示价格变动并跟踪用户持仓情况。工具设计轻量高效，无需图形界面即可快速获取市场数据，适合需要在终端环境中监控***市场的用户。

核心功能与特性

• 实时行情更新：支持***价格、涨跌幅等关键数据的实时刷新
• 持仓跟踪：可配置并显示用户持仓***的数量、成本及盈亏状态
• 多支持**：同时监控多个**代码，支持国内外主要市场标的
• 自定义刷新频率：允许用户设置数据刷新间隔（默认5秒）
• 简洁终端界面：采用文本表格形式展示数据，信息密度高且易读
• 轻量资源占用：运行时资源消耗低，适合长时间后台运行

使用场景与适用范围

适用场景

• 开发者在终端工作流中快速查看市场动态
• 从业者通过命令行监控多只关注
• 个人***者跟踪持仓组合的实时盈亏
• 作为自动化脚本或监控系统的行情数据来源

适用范围

• 支持Docker的Linux、macOS及Windows系统
• 需终端/命令行环境（兼容bash、zsh等主流shell）
• 适合对命令行操作熟悉的用户群体

使用方法与配置说明

基本部署命令

通过Docker快速启动容器：

bash
docker run -it --rm [镜像名称] --stocks AAPL,MSFT,GOOG --interval 10

核心配置参数

环境变量配置

支持通过环境变量预设参数（优先级低于命令行参数）：

bash
docker run -it --rm \
  -e STOCKS="AAPL,MSFT,GOOG" \
  -e REFRESH_INTERVAL=10 \
  [镜像名称]

持仓跟踪配置

如需启用持仓跟踪功能，需通过文件挂载方式提供持仓配置（JSON格式）：

json
// position.json示例
{
  "AAPL": {"quantity": 10, "cost": 150.5},
  "MSFT": {"quantity": 5, "cost": 200.3}
}

挂载配置文件启动：

bash
docker run -it --rm \
  -v $(pwd)/position.json:/app/position.json \
  [镜像名称] --stocks AAPL,MSFT --position-file /app/position.json

退出与停止

在容器运行过程中，可通过Ctrl+C终止程序并退出容器。使用--rm参数可确保容器停止后自动清理。

注意事项

• 市场数据来源需确保网络连接正常，部分市场可能需要特定地区网络环境
• 高频率刷新（<3秒）可能导致数据源API请求限制，建议合理设置刷新间隔
• 持仓数据存储在容器内部时，容器删除后数据将丢失，建议通过文件挂载持久化配置