opvious/api-server

Opvious API服务器

Opvious是一个功能齐全的数学优化平台，本镜像包含适合自托管的整合API服务器。

支持的标签

• latest
• <version>（具体版本号）

使用场景

适用于需要自托管数学优化服务的场景，如企业内部优化计算、科研项目中的优化问题求解等。

配置说明与部署示例

直接运行容器

sh
docker run -p 8080:8080 docker.xuanyuan.run/opvious/api-server

通过Opvious CLI部署（推荐）

Opvious CLI可透明管理服务器及其依赖（通过docker compose）：

sh
# 启动服务器及依赖
opvious api start
# 跟踪API服务器日志
opvious api logs -f

许可证

下载和使用本镜像需遵守Opvious API镜像最终用户许可协议。如需启用数据库持久化、异步求解等额外功能，可通过https://docs.google.com/forms/d/e/1FAIpQLSdnrKoQFOtiOEFCjLwG7GOPqTPYzYAOzIluYR8fJSbvQ2_AxQ/viewform申请单独许可证。

遥测配置

日志

日志 verbosity 由LOG_LEVEL环境变量控制，可全局或按库设置：

sh
# 全局info级别
LOG_LEVEL=info
# 全局info级别，highs-*包为debug级别
LOG_LEVEL=info,highs-*=debug

本地推荐使用https://github.com/pinojs/pino-pretty美化日志输出。

追踪

设置OTEL_EXPORTER_OTLP_TRACES_ENDPOINT环境变量为收集器URL，可导出OpenTelemetry兼容的追踪数据。例如使用Jaeger可视化：

sh
# 启动Jaeger all-in-one容器
docker run -e COLLECTOR_OTLP_ENABLED=true -p 16686:16686 -p 4318:4318 docker.xuanyuan.run/jaegertracing/all-in-one

将API服务器配置为OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://host.docker.internal:4318/v1/traces，并访问http://localhost:***即可查看追踪数据。默认全量采样，可通过https://opentelemetry.io/docs/instrumentation/js/sampling/#environment-variables。

指标

类似追踪，设置OTEL_EXPORTER_OTLP_METRICS_ENDPOINT环境变量为收集器URL，可导出OpenTelemetry兼容的指标数据。