calibertechnology/taxserver

Caliber Technology TaxServer 镜像文档

镜像概述

Caliber Technology TaxServer是一个HTTP/HTTPS服务器，提供简单API接口用于查询和计算美国工资预扣税。该镜像包含演示税表，涵盖美国所有州及大部分地方工资税的计算公式（演示版公式为几个月前的版本）。更多信息请访问[***]

核心功能和特性

• 税计算服务：提供API接口用于查询和计算美国工资预扣税
• 多协议支持：同时支持HTTP和HTTPS协议
• 演示税表：内置演示税表，包含所有州及大部分地方税计算逻辑
• 灵活配置：支持自定义HTTP/HTTPS端口
• 税表更新：可通过TaxUpdate订阅导入最新税表，或通过本地目录映射加载税表
• 税表合并：若加载多个税表，系统将自动合并所有税表数据

使用场景和适用范围

• 企业 payroll 系统集成，用于工资预扣税计算
• 税务相关应用开发的后端服务
• 美国工资税计算功能原型验证
• 云服务环境（如AWS、Azure、ECS/Fargate）部署

使用方法和配置说明

基本运行（HTTPS模式）

默认使用HTTPS协议，端口8443：

bash
docker run -p 8443:8443 calibertechnology/taxserver

启动后，在浏览器中访问https://localhost:8443（首次访问需忽略自签名证书安全警告），可查看API描述及使用示例。

HTTP模式运行

若需使用HTTP协议（默认端口80）：

bash
sudo docker run -p 80:80 calibertechnology/taxserver

自定义端口配置

通过环境变量HTTP_PORT和HTTPS_PORT自定义端口：

bash
# 示例：将HTTPS端口改为443
export HTTPS_PORT="443"
docker run --env HTTPS_PORT -p 443:443 calibertechnology/taxserver

使用TaxUpdate订阅导入最新税表

若拥有TaxUpdate订阅，可通过环境变量传入凭据自动下载最新税表：

bash
export USERNAME="<your_username>"
export PASSWORD="<your_password>"
docker run --env USERNAME --env PASSWORD -p 8443:8443 calibertechnology/taxserver

注：若下载失败，系统将自动使用内置演示税表，并在控制台显示相关信息。

本地税表加载

通过目录映射加载本地税表（映射本地目录到容器内/taxes目录）：

bash
# 示例：加载当前目录下local文件夹中的税表
docker run -v ./local:/taxes -p 8443:8443 calibertechnology/taxserver

若映射目录包含多个税表文件，系统将自动合并所有税表数据。

云服务部署注意事项

• 在AWS、Azure等云服务中，可通过CLI或Web界面设置USERNAME和PASSWORD环境变量
• 对于ECS/Fargate等不允许端口重定向的服务，可通过HTTP_PORT和HTTPS_PORT环境变量调整容器使用的端口
• 注意：容器实例仅限通过授权产品使用，不应被第三方直接访问

默认配置参数

• 默认HTTP端口：80
• 默认HTTPS端口：8443
• 内置演示税表：包含所有州及大部分地方税公式（几个月前版本）