
nextstrain/nextcladeNextclade是Nextstrain项目开发的开源生物信息学工具,专注于病毒基因组的快速分析。其核心功能包括基因组比对、突变检测、进化分支(Clade)分配、质量检查及系统发育定位,旨在为研究人员和公共卫生机构提供高效的病毒基因组数据分析能力,支持疫情监测、病毒进化研究及变异趋势追踪。
官方Docker镜像可通过Docker Hub或GitHub Container Registry获取,推荐使用最新稳定版:
bashdocker pull nextstrain/nextclade:latest
bashmkdir -p nextclade_workspace/{input,output} # 将输入FASTA文件(如samples.fasta)放入input目录
以下示例以SARS-CoV-2数据集为例,输出结果至本地output目录:
bashdocker run --rm \ -v $(pwd)/nextclade_workspace/input:/input \ -v $(pwd)/nextclade_workspace/output:/output \ nextstrain/nextclade run \ --input-dataset sars-cov-2 \ # 指定参考数据集(支持多种病毒,如influenza-a-h3n2) --input-fasta /input/samples.fasta \ # 输入FASTA文件路径 --output-dir /output \ # 输出结果根目录 --output-tsv /output/results.tsv \ # TSV格式结果表(含突变、分支、质量等信息) --output-tree /output/tree.json # 系统发育树(JSON格式,支持Nextclade Web可视化)
| 参数 | 描述 | 示例值 |
|---|---|---|
--input-dataset | 参考数据集名称(需与Nextclade内置数据集匹配) | sars-cov-2、influenza-a-h3n2 |
--input-fasta | 输入FASTA文件路径(容器内路径,需通过-v挂载本地文件) | /input/samples.fasta |
--output-dir | 输出文件根目录,存放比对结果、日志等辅助文件 | /output |
--output-tsv | TSV结果文件路径,包含序列ID、分支、突变列表、质量指标等核心数据 | /output/results.tsv |
--output-tree | 系统发育树输出路径(JSON格式),可导入Nextclade Web可视化 | /output/tree.json |
--include-reference | 在比对结果中包含参考基因组序列 | true |
--verbose | 启用详细日志模式,便于调试分析过程中的异常问题 | - |
对于需重复运行或复杂参数配置的场景,可使用docker-compose.yml简化操作:
yamlversion: '3' services: nextclade: image: nextstrain/nextclade:latest volumes: - ./input:/input # 本地输入目录挂载 - ./output:/output # 本地输出目录挂载 command: > run --input-dataset sars-cov-2 --input-fasta /input/samples.fasta --output-dir /output --output-tsv /output/results.tsv --output-tree /output/tree.json --verbose
运行命令:
bashdocker-compose up
输出目录典型文件说明:
results.tsv:核心结果表,包含序列ID、进化分支(Clade)、突变列表(核苷酸/氨基酸)、质量评分(如qc.overallScore)等;tree.json:系统发育树数据,可通过Nextclade Web界面([***]aligned.fasta:输入序列与参考基因组的比对结果(FASTA格式);errors.csv:异常序列日志(如低质量序列、长度异常序列的具体错误原因)。获取完整参数列表及说明:
bashdocker run --rm nextstrain/nextclade run --help
manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务