如果你用 DeepSeek、元宝AI、Copilot 等 AI 代为编写轩辕镜像的 docker pull、修改 compose 镜像地址,或排查拉取失败等问题,请让 AI 先读规则再动手,只要在 AI 对话里直接发送下面这句话即可:
生成 docker pull、修改 compose 的 image,或排查拉取失败前,请先阅读并严格遵守 https://xuanyuan.cloud/agents.md 中的规则。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
为项目点亮星标 🌟,以获取发布通知并助力社区发展!
intuitem.com · SaaS 免费试用 · 路线图 · 文档 · 语言 · *** · 框架
CISO Assistant 为网络安全管理和GRC(治理、风险与合规)实践提供了全新视角:
我们的愿景是打造网络安全管理的一站式平台,通过简化和互操作性实现 GRC 现代化。
作为与网络安全和 IT 专业人员合作的从业者,我们曾面临同样的问题:工具碎片化、数据重复,以及缺乏直观的集成解决方案。CISO Assistant 源于这些经验教训,我们正围绕务实、常识性原则构建社区。
我们不断根据用户和客户的反馈进行改进。CISO Assistant 就像章鱼 🐙 一样,不断长出新的“触手”——为网络安全团队带来清晰度、自动化和生产力,同时减少数据输入和输出的工作量。
[!NOTE] 最简单的入门方式是通过此处提供的云实例免费试用。
或者,在工作站或服务器上安装好 Docker 和 Docker-compose 后:
克隆仓库:
git clone --single-branch -b main https://github.com/intuitem/ciso-assistant-community.git
并运行启动脚本
./docker-compose.sh # Linux/MacOS
./docker-compose.ps1 # Windows
如果您正在寻找其他自托管安装选项,请查看配置生成器和文档。
[!NOTE] docker-compose 脚本使用预构建的 Docker 镜像,支持大多数标准硬件架构。如果您使用Windows,请确保已安装带 WSL2 的 Docker Desktop并触发 PowerShell 脚本。它将代表您配置 Docker Desktop。
可以调整 docker compose 文件以传递额外参数,以适应您的设置(例如邮件发送器设置)。
[!WARNING] 如果您收到镜像平台与主机平台不匹配的警告或错误,请提交包含详细信息的 issue,我们将很快添加支持。您也可以改用
docker-compose-build.sh(见下文)为特定架构构建镜像。
[!IMPORTANT] 不要将
main分支代码直接用于生产环境,因为它是合并上游,在我们的开发过程中可能会有破坏性变更。请使用稳定版本的tags或预构建镜像。
即将推出的功能列在路线图中。
CISO Assistant 由Intuitem开发和维护,该公司专注于网络安全、云以及数据/人工智能领域。
以下是 CISO Assistant 中部分构建块的摘要,用于说明鼓励复用的解耦概念:
有关完整详情,请查看数据模型文档。
CISO Assistant 的核心是解耦原则,它支持强大的用例并显著节省时间:
以下是解耦原则及其优势的说明:
查看 上的在线文档。
在此处了解更多:AI 引擎
库可以表示一个框架、一个威胁目录、一组参考控制措施,甚至是一个自定义风险矩阵。
现在可以直接从 Excel 文件加载库。无需事先手动将其转换为 YAML——上传 Excel 文件时会在内部处理转换。
查看 tools 目录及其专用 README,其中描述了 Excel 中库源文件的预期格式。excel 子目录包含用作现有库源的示例 XLSX 文件,可用作创建您自己的库的模板。
要从 Excel 文件加载库,请转到 Governance → Library 页面,点击 Load,然后选择您的 Excel 源文件。导入过程中会报告任何验证或解析错误。
虽然可以直接加载 Excel 文件,但仍可以使用外部 Python 脚本将库源文件转换为 YAML:
convert_library_v2.py 帮助您从简单的 Excel 文件生成库。一旦您的项目按照预期格式结构化,运行该脚本即可生成相应的 YAML 文件。tools 目录还包含针对特定框架的专用转换器(例如,CIS 或 CCM Controls)。为便于创建框架之间的映射,您可以使用 prepare_mapping_v2.py 工具。它基于两个现有的 YAML 格式框架库生成 Excel 文件。填写映射后,生成的 Excel 文件可以:
convert_library_v2.py 转换为 YAML。git clone git@github.com:intuitem/ciso-assistant-community.git
cd ciso-assistant-community
../myvars),通过复制并修改以下代码将环境变量存储在其中,并将 " " 替换为您的私有值。注意不要将此文件提交到您的 git 仓库中。必填变量
后端中的所有变量都有便捷的默认值。
推荐变量
export DJANGO_DEBUG=True
# 默认 URL 设为 http://localhost:5173,但您可以修改,例如使用 Caddy 代理启用 HTTPS
export CISO_ASSISTANT_URL=https://localhost:8443
# 例如使用 Mailhog 设置开发邮件服务器
export EMAIL_HOST_USER=''
export EMAIL_HOST_PASSWORD=''
export DEFAULT_FROM_EMAIL=ciso-assistant@ciso-assistantcloud.com
export EMAIL_HOST=localhost
export EMAIL_PORT=1025
export EMAIL_USE_TLS=True # true 表示使用 STARTTLS
export EMAIL_USE_SSL=False # true 表示使用 SMTPS
其他变量
# CISO Assistant 默认使用 SQLite,但您可以通过声明以下变量来设置 PostgreSQL
export POSTGRES_NAME=ciso-assistant
export POSTGRES_USER=ciso-assistantuser
export POSTGRES_PASSWORD=
export POSTGRES_PASSWORD_FILE= # 指定密码的另一种方式
export DB_HOST=localhost
export DB_PORT=5432 # 可选,默认值为 5432
# CISO Assistant 默认使用文件系统存储后端。
# 一次只能激活一个云存储后端(USE_S3 和 USE_AZURE 互斥)。
# --- AWS S3 ---
# 您可以通过声明以下变量使用 S3 存储桶
# 启动 CISO Assistant 前必须创建 S3 存储桶
export USE_S3=True
export AWS_STORAGE_BUCKET_NAME=
export AWS_S3_REGION_NAME= # 可选,例如 us-east-1
# S3 身份验证选项 1:访问密钥(适用于独立部署或 S3 兼容服务)
export AWS_ACCESS_KEY_ID=
export AWS_SECRET_ACCESS_KEY=
export AWS_S3_ENDPOINT_URL= # S3 兼容服务(如 MinIO)必填
# S3 身份验证选项 2:IRSA(适用于 Kubernetes/EKS 部署)
# 在启用了 IAM Roles for Service Accounts (IRSA) 的 EKS 上运行时,
# 这些环境变量由 Pod 的服务账户自动注入。
# 无需显式配置——只需确保设置了 USE_S3=True 和 AWS_STORAGE_BUCKET_NAME。
# export AWS_WEB_IDENTITY_TOKEN_FILE=/var/run/secrets/eks.amazonaws.com/serviceaccount/token
# export AWS_ROLE_ARN=arn:aws:iam::123456789012:role/ciso-assistant-s3-role
# --- Azure Blob Storage ---
# 您可以使用 Azure Blob Storage 容器代替 S3。
# 启动 CISO Assistant 前必须创建容器。
# export USE_AZURE=True
# export AZURE_CONTAINER= # 默认:ciso-assistant-container
# export AZURE_CUSTOM_DOMAIN= # 可选,例如 cdn.example.com
# export AZURE_LOCATION= # 可选,容器内的路径前缀(例如 "media")
# Azure 身份验证选项 1:账户密钥
# export AZURE_ACCOUNT_NAME=
# export AZURE_ACCOUNT_KEY=
# Azure 身份验证选项 2:连接字符串
# export AZURE_CONNECTION_STRING=
# Azure 身份验证选项 3:托管身份(适用于 Azure 托管部署)
# 需要 AZURE_ACCOUNT_NAME。Pod/VM 分配的托管身份会自动使用。
# export AZURE_ACCOUNT_NAME=
# export AZURE_USE_MANAGED_IDENTITY=True
# 添加第二个备份邮件服务器(已弃用,不再推荐)
export EMAIL_HOST_RESCUE=
export EMAIL_PORT_RESCUE=587
export EMAIL_HOST_USER_RESCUE=
export EMAIL_HOST_PASSWORD_RESCUE=
export EMAIL_USE_TLS_RESCUE=True
export EMAIL_USE_SSL_RESCUE=False
# 您可以定义第一个超级用户的邮箱,便于自动化。系统会向超级用户发送密码初始化邮件
export CISO_SUPERUSER_EMAIL=
# 默认情况下,Django 密钥在每次启动 CISO Assistant 时随机生成。这便于快速测试,
# 但不推荐用于生产环境,因为可能会破坏会话(更多信息参见
# 此 [主题](https://stackoverflow.com/questions/15170637/effects-of-changing-djangos-secret-key))。
# 要设置固定密钥,请使用环境变量 DJANGO_SECRET_KEY。
export DJANGO_SECRET_KEY=...
# 用于运行不受信任代码(例如库 Excel 文件)的沙箱模式
# 警告:生产环境必须启用沙箱。
export ENABLE_SANDBOX=True # 可选,生产环境(DJANGO_DEBUG=False)默认值为 True,开发环境(DJANGO_DEBUG=True)默认值为 False。
# 日志配置
export LOG_LEVEL=INFO # 可选,默认值为 INFO。可用选项:DEBUG、INFO、WARNING、ERROR、CRITICAL
export LOG_FORMAT=plain # 可选,默认值为 plain。可用选项:json、plain
pre-commit install
psql as superadmin
sudo su postgres
psql
create database ciso-assistant;
create user ciso-assistantuser with password ' ';
grant all privileges on database ciso-assistant to ciso-assistantuser;
[!NOTE] docker-compose 模板文件现在以非 root 模式启动后端、huey 和前端。如果您使用旧的 docker-compose.yml 文件,建议进行更新。容器同时兼容 root 和非 root 模式。
docker compose down
sudo chown -R 1001:1001 db
docker compose up -d
参考文件为 en.json;覆盖率 = 每个区域文件中存在的参考键占比。每日自动刷新 — 详细分类请参见 https://intuitem.github.io/metrics/i18n/%E3%80%82
我们已尽力遵循安全最佳实践。请向 报告任何问题。
本仓库包含 CISO Assistant 开源版(社区版)和商业版(专业版和企业版)的源代码,其中开源版基于 AGPL v3 许可协议发布,商业版基于 intuitem 商业软件许可协议发布。为简化起见,采用了单体仓库方案。
顶级“enterprise”目录中的所有文件均基于 intuitem 商业软件许可协议发布。
顶级“enterprise”目录之外的所有文件均基于 AGPLv3 许可协议发布。
详情参见 LICENSE.md。有关商业版的更多详情,您可以通过 联系我们。
除非另有说明,所有文件均 © intuitem。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
发给 Cursor、ChatGPT、豆包等 AI 的说明文档
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
原仓库同步与拉取
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
不支持 push
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
Schema 1 已废弃
406 OCI index
422 Unknown
400 TAG_INVALID
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务