teamdigitale/italia-backend
teamdigitale
自动构建
意大利数字公民应用（italia-app）的后端服务，支持Web和移动应用的SPID认证、会话管理、数据交互等核心功能，是意大利数字公民项目的重要组成部分。
下载次数: 0状态：自动构建维护者：teamdigitale仓库类型：镜像最近更新：6 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
意大利数字公民应用后端
镜像概述
该镜像为意大利数字公民项目（Digital Citizenship）的后端服务，支撑https://github.com/teamdigitale/italia-web%E5%92%8Chttps://github.com/teamdigitale/italia-app%E7%9A%84Web%E5%8F%8A%E7%A7%BB%E5%8A%A8%E5%BA%94%E7%94%A8%EF%BC%8C%E6%8F%90%E4%BE%9B%E7%94%A8%E6%88%B7%E8%AE%A4%E8%AF%81%E3%80%81%E6%95%B0%E6%8D%AE%E5%A4%84%E7%90%86%E3%80%81API%E4%BA%A4%E4%BA%92%E7%AD%89%E6%A0%B8%E5%BF%83%E8%83%BD%E5%8A%9B%E3%80%82
核心功能
- SPID认证流程：基于SAML2的两步认证（SPID登录生成会话token，后续请求用token验证）；
- 会话管理：通过Redis存储用户会话信息，控制token有效期；
- API交互：对接PagoPA等外部服务，处理通知和支付请求；
- 监控与日志：支持AppInsights监控API性能，日志存储于本地文件夹；
- 版本兼容：通过
minAppVersion控制移动应用最低兼容版本。
使用场景
- 作为italia-app移动应用的后端支撑，处理用户登录、数据查询；
- 为italia-web提供SPID认证和会话管理；
- 对接外部服务实现支付、通知等扩展功能。
配置说明
环境变量（部分关键变量）
| 变量名 | 描述 | 类型 |
|---|---|---|
| API_KEY | API后端认证密钥 | string |
| REDIS_URL | Redis实例地址 | string |
| TOKEN_DURATION_IN_SECONDS | 会话token有效期（秒） | int |
| SAML_CALLBACK_URL | SAML断言消费服务端点URL | string |
Docker部署步骤
- 克隆项目：
git clone https://github.com/teamdigitale/italia-backend.git - 进入目录：
cd italia-backend - 构建工具镜像：
scripts/build-tools.sh - 安装依赖：
scripts/yarn.sh - 生成API模型：
scripts/generate-proxy-api-models.sh - 编译代码：
scripts/build.sh - 生成测试证书：
scripts/generate-test-certs-task.sh - 启动容器：
docker-compose up -d - 配置hosts：添加
localhost italia-backend spid-testenv2到/etc/hosts - 访问服务：
https://italia-backend
故障排除
- Host无法访问：检查/etc/hosts配置，Docker Machine用户替换localhost为机器IP；
- 端口冲突：修改docker-compose.yml中的端口映射（如80、8088端口）。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 italia-backend 镜像标签
docker pull docker.xuanyuan.run/teamdigitale/italia-backend:<标签>
DockerHub 原生拉取命令
docker pull teamdigitale/italia-backend:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"