OpenSandbox元数据存储架构SQLite本地存储与快照记录管理【免费下载链接】OpenSandboxSecure, Fast, and Extensible Sandbox runtime for AI agents.项目地址: https://gitcode.com/GitHub_Trending/ope/OpenSandboxOpenSandbox 是一个面向 AI Agent 的安全、快速、可扩展的沙箱运行时。在管理成百上千个沙箱实例时服务端必须可靠地保存沙箱元数据与快照记录——这正是 OpenSandbox 元数据存储架构要解决的核心问题。本文带你快速看懂它的默认方案SQLite 本地存储如何实现零配置持久化以及快照记录管理Snapshot Record如何通过单表模型、状态机与乐观并发控制让本地开发和生产切换都变得简单。为什么需要元数据存储 沙箱的生命周期涉及大量需要记住的信息实例 ID、所属命名空间、过期时间、标签、端口映射、快照状态等。OpenSandbox 服务端opensandbox_server将这些元数据统一持久化到本地存储中好处是零依赖默认使用 SQLite 单文件数据库无需部署 MySQL 或 PostgreSQL可迁移通过工厂模式可无缝切换 PostgreSQL 后端可恢复服务端重启后所有沙箱与快照记录完整保留。SQLite 本地存储默认即开箱即用OpenSandbox 的存储配置集中在 config.py 的StoreConfig中默认值十分友好配置项默认值说明store.typesqlite持久化后端类型store.path~/.opensandbox/opensandbox.dbSQLite 数据库文件路径这意味着启动 OpenSandbox 服务端后无需任何额外操作元数据库文件就会自动出现在你的用户主目录下。数据库的连接配置也考虑了并发场景见 sqlite.pyWAL 日志模式PRAGMA journal_modeWAL读写并发更流畅避免数据库被锁定错误5 秒忙等待超时busy_timeout5000多进程争用连接时自动排队而非立即报错。快照记录管理一张表管到底 快照Snapshot是 OpenSandbox 的核心能力之一——把运行中的沙箱状态固化下来随时可恢复。所有快照记录都存储在snapshots单表中表结构定义在 sqlite.py字段作用id快照唯一主键source_sandbox_id来源沙箱 IDnamespace命名空间多租户隔离name/description快照名称与描述restore_configJSON 序列化的恢复配置state/reason/message状态机字段created_at/updated_at时间戳表上建有三个索引source_sandbox_id、state、created_at DESC以及(name, namespace)联合索引保证按沙箱查、按状态过滤、按时间翻页三类高频查询都足够快。状态机与乐观并发控制 快照不是静态数据它会在创建中 → 就绪 → 恢复中等状态间流转。为了避免两个请求同时操作同一快照造成数据错乱OpenSandbox 提供了update_if_state方法见 sqlite.py更新语句附带WHERE id ? AND state ?条件——只有当前状态与预期一致时更新才会生效否则直接失败。这是一种典型的乐观并发控制不靠锁而是靠状态校验来保证一致性简单且高效。自动迁移老数据也能平滑升级如果你从旧版本升级仓库里内置了自动迁移逻辑sqlite.py启动时自动检测snapshots表是否缺少namespace列缺了就ALTER TABLE补上甚至能把 NOT NULL 的namespace平滑重建为可空列支持非租户模式。整个过程无需手工执行 SQL。如何切换到 PostgreSQL 后端生产环境多副本部署时只需在配置中修改两处示例见 example.config.toml[store] type postgresql [store.postgresql] dsn postgresql://user:passhost:5432/opensandbox后端的实际选择由工厂函数create_snapshot_repository完成factory.py读取store.type创建对应的SQLiteSnapshotRepository或PostgreSQLSnapshotRepository。上层服务代码完全无感——这就是仓储Repository模式的价值。相关资源 资源路径SQLite 快照仓储server/opensandbox_server/repositories/snapshots/sqlite.pyPostgreSQL 快照仓储server/opensandbox_server/repositories/snapshots/postgresql.py后端工厂server/opensandbox_server/repositories/snapshots/factory.py存储配置定义server/opensandbox_server/config.py服务端文档docs/components/server.md快照迁移说明docs/reference/snapshot-store-migration.md总结OpenSandbox 的元数据存储架构用最小的复杂度解决了最重要的问题默认 SQLite 单文件本地开发零配置快照记录一张表 状态机 乐观锁简单可靠工厂模式预留 PostgreSQL 切换通道。对于正在搭建 AI Agent 沙箱环境的新手你完全不需要关心这些细节——默认配置即可运行而当你的系统走向生产时又有一条清晰的升级路径等着你。【免费下载链接】OpenSandboxSecure, Fast, and Extensible Sandbox runtime for AI agents.项目地址: https://gitcode.com/GitHub_Trending/ope/OpenSandbox创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OpenSandbox元数据存储架构：SQLite本地存储与快照记录管理
OpenSandbox元数据存储架构SQLite本地存储与快照记录管理【免费下载链接】OpenSandboxSecure, Fast, and Extensible Sandbox runtime for AI agents.项目地址: https://gitcode.com/GitHub_Trending/ope/OpenSandboxOpenSandbox 是一个面向 AI Agent 的安全、快速、可扩展的沙箱运行时。在管理成百上千个沙箱实例时服务端必须可靠地保存沙箱元数据与快照记录——这正是 OpenSandbox 元数据存储架构要解决的核心问题。本文带你快速看懂它的默认方案SQLite 本地存储如何实现零配置持久化以及快照记录管理Snapshot Record如何通过单表模型、状态机与乐观并发控制让本地开发和生产切换都变得简单。为什么需要元数据存储 沙箱的生命周期涉及大量需要记住的信息实例 ID、所属命名空间、过期时间、标签、端口映射、快照状态等。OpenSandbox 服务端opensandbox_server将这些元数据统一持久化到本地存储中好处是零依赖默认使用 SQLite 单文件数据库无需部署 MySQL 或 PostgreSQL可迁移通过工厂模式可无缝切换 PostgreSQL 后端可恢复服务端重启后所有沙箱与快照记录完整保留。SQLite 本地存储默认即开箱即用OpenSandbox 的存储配置集中在 config.py 的StoreConfig中默认值十分友好配置项默认值说明store.typesqlite持久化后端类型store.path~/.opensandbox/opensandbox.dbSQLite 数据库文件路径这意味着启动 OpenSandbox 服务端后无需任何额外操作元数据库文件就会自动出现在你的用户主目录下。数据库的连接配置也考虑了并发场景见 sqlite.pyWAL 日志模式PRAGMA journal_modeWAL读写并发更流畅避免数据库被锁定错误5 秒忙等待超时busy_timeout5000多进程争用连接时自动排队而非立即报错。快照记录管理一张表管到底 快照Snapshot是 OpenSandbox 的核心能力之一——把运行中的沙箱状态固化下来随时可恢复。所有快照记录都存储在snapshots单表中表结构定义在 sqlite.py字段作用id快照唯一主键source_sandbox_id来源沙箱 IDnamespace命名空间多租户隔离name/description快照名称与描述restore_configJSON 序列化的恢复配置state/reason/message状态机字段created_at/updated_at时间戳表上建有三个索引source_sandbox_id、state、created_at DESC以及(name, namespace)联合索引保证按沙箱查、按状态过滤、按时间翻页三类高频查询都足够快。状态机与乐观并发控制 快照不是静态数据它会在创建中 → 就绪 → 恢复中等状态间流转。为了避免两个请求同时操作同一快照造成数据错乱OpenSandbox 提供了update_if_state方法见 sqlite.py更新语句附带WHERE id ? AND state ?条件——只有当前状态与预期一致时更新才会生效否则直接失败。这是一种典型的乐观并发控制不靠锁而是靠状态校验来保证一致性简单且高效。自动迁移老数据也能平滑升级如果你从旧版本升级仓库里内置了自动迁移逻辑sqlite.py启动时自动检测snapshots表是否缺少namespace列缺了就ALTER TABLE补上甚至能把 NOT NULL 的namespace平滑重建为可空列支持非租户模式。整个过程无需手工执行 SQL。如何切换到 PostgreSQL 后端生产环境多副本部署时只需在配置中修改两处示例见 example.config.toml[store] type postgresql [store.postgresql] dsn postgresql://user:passhost:5432/opensandbox后端的实际选择由工厂函数create_snapshot_repository完成factory.py读取store.type创建对应的SQLiteSnapshotRepository或PostgreSQLSnapshotRepository。上层服务代码完全无感——这就是仓储Repository模式的价值。相关资源 资源路径SQLite 快照仓储server/opensandbox_server/repositories/snapshots/sqlite.pyPostgreSQL 快照仓储server/opensandbox_server/repositories/snapshots/postgresql.py后端工厂server/opensandbox_server/repositories/snapshots/factory.py存储配置定义server/opensandbox_server/config.py服务端文档docs/components/server.md快照迁移说明docs/reference/snapshot-store-migration.md总结OpenSandbox 的元数据存储架构用最小的复杂度解决了最重要的问题默认 SQLite 单文件本地开发零配置快照记录一张表 状态机 乐观锁简单可靠工厂模式预留 PostgreSQL 切换通道。对于正在搭建 AI Agent 沙箱环境的新手你完全不需要关心这些细节——默认配置即可运行而当你的系统走向生产时又有一条清晰的升级路径等着你。【免费下载链接】OpenSandboxSecure, Fast, and Extensible Sandbox runtime for AI agents.项目地址: https://gitcode.com/GitHub_Trending/ope/OpenSandbox创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考