Perkeep 服务器配置完全指南：从简单模式到低级别配置实战

后端数据存储【免费下载链接】perkeepPerkeep (née Camlistore) is your personal storage system for life: a way of storing, syncing, sharing, modelling and backing up content.项目地址https://gitcode.com/gh_mirrors/pe/perkeep点击查看免费下载导读Perkeep前身 Camlistore的服务器perkeepd通过一个 JSON 配置文件控制全部行为认证方式、HTTPS、存储后端、索引数据库、内容发布与导入器。本文基于 doc/server-config.md 系统讲解该配置文件的两层模型——面向日常使用的「简单模式simple mode」与面向高级定制的「低级别模式low-level mode」并结合仓库源码pkg/types/serverconfig/config.go、pkg/serverinit/genconfig.go、pkg/serverinit/serverinit.go深入解析每个配置项的底层语义与校验逻辑。读完本文你将能独立完成 Perkeep 服务器的初始化、认证加固、存储后端选型、索引数据库搭建、图片发布与跨实例复制等全套配置工作。配置文件的两层模型Perkeep 服务器的配置文件位于$HOME/.config/perkeep/server-config.json格式为 JSON。它存在两种形态简单模式simple mode适合基础配置使用auth、listen、blobPath等高层次键由pkg/serverinit在启动时自动翻译为内部使用的低级别配置。低级别模式low-level mode面向任意复杂度的配置直接以 URL 前缀prefix为单位声明每个 HTTP handler 及其参数。二者的判定规则非常明确配置文件顶层若存在handlerConfig: true键值对即视为低级别配置。这一点在 pkg/serverinit/serverinit.go 的LoadFile函数中体现读取文件后先检查OptionalBool(handlerConfig, false)为真则按低级别配置直接解析否则将 JSON 反序列化为serverconfig.Config结构体再调用genLowLevelConfig生成低级别配置。serverconfig.Config结构体见 pkg/types/serverconfig/config.go定义了简单模式支持的全部字段下文逐一展开。简单模式核心配置键auth认证机制auth键声明服务器采用的认证机制pkg/auth/auth.go 中注册了none、localhost、userpass、token、devauth、basic、tailscale七种方案。常用取值如下取值含义none完全无认证任何人都可访问None模式对所有请求返回OpAll权限localhost仅接受来自本机的连接在 Linux 上还要求请求发起者是运行服务器的同一用户userpass:alice:secretHTTP Basic 认证用户名alice、密码secret仅在启用 HTTPS 时推荐userpass:alice:secret:localhost同上但额外允许本机认证OrLocalhost trueuserpass:alice:secret:vivifyothersecretalice 主密码为secret另设「活化vivify」密码othersecret仅允许最小操作集可上传新内容但无法读取任何已有内容tailscale:ARG仅允许通过 Tailscale 网络访问ARG为full-access-to-tailnettailnet 内任意实体若在网络层可达服务器即获得完整读写权限或foobar仅允许指定的邮箱/类邮箱地址如foogithub从源码看userpass的解析逻辑在 pkg/auth/auth.go冒号分割后依次处理localhost与vivify选项vivify 密码对应OpVivify权限位OpUpload | OpStat | OpGet | OpDiscovery即只能上传与读取自身写入的 blob不能枚举、删除或访问他人内容。tailscale认证实现在 pkg/auth/tailscaleauth.go通过请求上下文中的 Tailscale 服务器调用WhoIs校验远端身份。baseURL 与 listen对外地址与监听端口baseURL可选。非空时表示服务器的 URL 前缀根用于反向代理场景末尾不能带斜杠例如https://yourserver.example.com。生成低级别配置时会校验其必须只含 scheme、主机与可选端口不能带路径见 genconfig.go。listen监听地址。可为端口80或:80、IP 与端口10.0.0.2:8080。若未配置genconfig.go 中的默认值defaultBaseConfig为:3179。listen亦可取tailscale或tailscale:ARG表示仅运行在 Tailscale 网络tailnet上。此时可选的ARG若是含斜杠的目录则作为状态存储目录否则视为实例名状态目录放在~/.config/tsnet-NAME默认实例名为perkeep。httpsHTTPS 与证书https设为true时启用 HTTPS配套两个键httpsCertHTTPS 证书文件路径公钥文件应包含所有必需的中间证书的拼接。httpsKeyHTTPS 私钥文件路径。证书处理的优先级在 genconfig.go 中强制httpsCert与httpsKey必须成对出现显式指定证书与密钥直接使用未显式指定时若满足以下两个条件则自动向 Lets Encrypt 申请证书baseURL或listen中指定了完全限定域名FQDN且 Perkeep 监听在443端口以应答 TLS-SNI 挑战若未找到 FQDN则生成自签名证书作为兜底。identity 与 identitySecretRingGPG 身份identity你的 GPG 指纹。新用户首次启动时自动生成密钥对知情者可以自行修改。identitySecretRingGnuPG 私钥环文件路径。新用户启动时自动生成知情者可以自行修改。自动生成的逻辑在 genconfig.go 的getOrMakeKeyring若密钥环文件已存在则复用其中的 keyID否则调用jsonsign.GenerateNewSecRing生成新密钥环。另外longIdentitygenconfig.go会将 8 位短形式或 40 位指纹统一规范为 16 位长 keyID并要求身份值全部大写。shareHandler 与 shareHandlerPath分享功能shareHandler设为true时启用服务器分享功能让朋友能访问你明确分享的内容。URL 前缀默认/share/。shareHandlerPath可选。非空时指定分享 handler 的 URL 前缀路径同时忽略shareHandler的值即视为已启用。例如/public/。源码中genconfig.go确认当shareHandler为真且shareHandlerPath为空时后者自动补全为/share/。runIndex 与 copyIndexToMemory索引与内存策略runIndex默认true。设为false则关闭搜索、UI 与索引这些可在低级别配置中做更细粒度的控制。copyIndexToMemory默认true。设为false时启动时不将整个索引载入内存但会导致部分查询变慢、不可用或结果无序属于进行中的功能未来可能不再支持官方建议保持true。注意runIndex与copyIndexToMemory在结构体中是以invertedBool类型实现的config.goJSON 中的布尔值与内存值取反——即 JSON 写runIndex: false表示逻辑上的 false不运行索引缺省时逻辑值为 true。sourceRoot覆盖内嵌资源sourceRoot可选。非空时指定替代的 Perkeep 源码树路径用于覆盖内嵌的 UI 与 Closure 资源。UI 文件预期位于sourceRoot/server/perkeepd/uiClosure 库位于sourceRoot/third_party/closure/lib。存储选项本地磁盘与云存储存储部分至少必须设置一项可选项如下对应 config.go 的字段定义memoryStoragetrue时 blob 仅存内存一般只用于调试与开发。blobPath本地磁盘路径用于存储 blob对 diskpacked 也有效。s3格式accessKey:secretKey:bucketName[/optional/dir][:hostname]。b2格式accessKey:secretKey:bucketName[/optional/dir]:hostname。googlecloudstorage格式clientId:clientSecret:refreshToken:bucketName[/optional/dir]。s3的hostname值可指向 S3 兼容端点如my-minio-server.example.com以替代 AWS S3如需指定区域只能通过低级别配置实现不过 bucket 区域通常会被自动探测。另有两个互斥的打包选项packRelated为true时自动重新打包 blob 以加速读取对应 blobpacked 存储。packBlobs为true时使用 diskpacked 替代默认的文件存储写吞吐更高但读访问更慢。互斥校验在 genconfig.gocant use both packBlobs (for diskpacked) and packRelated (for blobpacked)。此外 genconfig.go 还强制了组合约束除非memoryStorage为真否则至少需要blobPath、s3、b2、googlecloudstorage之一memoryStorage与blobPath互斥。若同时设置多个存储选项则其中一个为主存储其余自动设为镜像优先级顺序与上表列出的顺序一致memoryStorage 优先于 blobPath依此类推。更多存储后端场景请参考 doc/storage-examples.md。简单模式暂未支持的其他后端欢迎向 pkg/serverinit/genconfig.go 提交补丁。索引选项七种索引后端除非runIndex设为false否则必须且只能精确设置一个索引选项sqliteSQLite 数据库文件路径。kvIndexFilekvmodernc.org/kv数据库文件路径。levelDBlevelDB 数据库文件路径。mongouser:passwordhost。mysqluserhost:password。postgresuserhost:password。memoryIndextrue时使用纯内存索引器。该约束在 genconfig.go 中硬编码runIndex为真且索引选项数为 0 时报错多于 1 个同样报错。值得注意的细节mysql/postgres字符串使用userhost:password格式解析函数parseUserHostPassgenconfig.go通过启发式规则处理端口号——host:port中可识别的数字段会被合并回 host。数据库相关选项dbname可选MySQL、PostgreSQL 或 MongoDB 作索引数据库时的数据库名。为空时用dbUnique参与拼出库名。dbUnique可选用于在共享同一 DBMS 的多个 Perkeep 实例间区分数据库不应包含空格或标点。为空时依次回退到identity、当前操作系统用户名。索引数据库命名以dbname优先。库名的实际生成规则在 genconfig.go 的dbName中统一以pk_前缀开头依次拼接dbUnique与组件名index、blobpacked、diskpacked、uithumbmeta、syncto_*例如pk_mykeyid_index。使用 MariaDB 或 MySQL 时数据库用户除了默认 schema 外还需具备建库能力至少需要grant create, insert, update, delete, alter, show databases on *.*权限。初始化数据库使用pk的dbinit子命令见 cmd/pk/dbinit.go支持--user、--password、--host、--dbname、--dbtypemysql/postgres/sqlite/mongo、--sslmodepostgresrequire/verify-full/disable、--wipe、--ignoreexists等参数。示例pk dbinit --userfoo --passwordbar --hostlocalhost --dbnamecamliprod --wipe实现细节可参考 cmd/pk/dbinit.go 与 pkg/sorted/mysql。发布Publishing配置图片画廊与反向代理Perkeep 使用 Go html 模板渲染发布页面通过publish键配置。已内置图片画廊视图配置示例camliRoot视实际情况而定publish: { /pics/: { camliRoot: mypics, cacheRoot: /home/joe/var/perkeep/blobs/cache, goTemplate: gallery.html } }publish的完整参数定义见 config.go 的Publish类型camliRoot决定发布根 permanode、goTemplate是app/publisher/目录下的模板文件名、cacheRoot是图片缓存根为空则不缓存、sourceRoot可覆盖模板与静态资源、program默认publisher并内嵌App通用配置listen、backendURL、apiHost、httpsCert、httpsKey。发布前可用pk-put或 Web UI 创建任意 permanode并将其camliRoot属性设置为配置中对应的值作为发布根 permanode。反向代理场景常见用法是 Perkeep及 publisher 应用运行在反向代理如 Nginx之后由代理负责 TLS 终结此时 perkeepd 与 publisher 监听非 TLS HTTP 连接即可并需要指定 app handler 配置参数publish: { /pics/: { camliRoot: mypics, cacheRoot: /home/joe/var/perkeep/blobs/cache, goTemplate: gallery.html, apiHost: http://localhost:3179/, listen: :44352, backendURL: http://localhost:44352/ } }其中apiHost是 app 用于调用 Perkeep API 的 URL 前缀listen是 publisher 进程自己的监听地址backendURL是 app handler 反代到应用进程的 URL。注意反向代理不应修改入站请求的 Host 头。生成低级别配置时addAppConfiggenconfig.go负责把这些参数透传给 app handler。另外源码校验genconfig.go要求发布功能依赖索引publishing requires an index。发布 permanode 的完整设置流程与自定义发布视图的开发方式参见 doc/publishing/README.md。导入器ImportersPerkeep 内置多个导入器包括FeedsRSS、Atom、RDFFlickrFoursquarePicasaPinboardTwitterInstapaper通过访问/importer/URL 前缀进行配置例如http://localhost:3179/importer/。低级别配置中每个导入器以clientSecret等参数挂载可参考 config/dev-server-config.json 的/importer/段示例。Windows 平台建议用 MySQL 替代 SQLiteWindows 上默认配置的 SQLite 索引器依赖 mattn/go-sqlite3在 Windows 上编译运行并不顺利官方建议改用 MySQL 等其他索引器。步骤如下下载安装 MariaDB 或 MySQL后者需要 .NET。编辑服务器配置文件若尚未存在运行perkeepd会自动创建移除sqlite选项添加dbname选项如dbname: camliprod添加mysql选项如mysql: foolocalhost:bar。为 MySQL 服务器创建专用用户与密码。用pk初始化数据库pk dbinit --userfoo --passwordbar --hostlocalhost --dbnamecamliprod --wipe。MongoDB 的设置更简单但其索引器不如 MySQL 索引器成熟稳定。低级别配置进阶定制的入口低级别配置通过与简单模式相同的-configfile选项传给 perkeepd该 flag 定义在 server/perkeepd/perkeepd.go也支持从http:/https:URL 拉取。Perkeep 依据顶层handlerConfig: true键值对判定是否为低级别模式serverinit.go。由于低级别配置要求极其详细精确不建议从零手写。最稳妥的起步方式是先用简单配置或空配置会自动生成运行一次 Perkeep然后从实例的/debug/config端点下载等价低级别配置作为模板。该端点的实现在 serverinit.go会以缩进 JSON 输出当前低级别配置并自动将auth、aws_secret_access_key、password、client_secret等敏感字段替换为REDACTED。仓库中的 config/dev-server-config.json 就是一份完整的低级别配置示例展示了root、ui、search、sync、storage-blobpacked、storage-replica、storage-encrypt、storage-index、importer、share等 handler 的典型组合可作为手写低级别配置的参考蓝本。复制到另一台 Perkeep 实例Replication假设主实例的存储为/bs例如 blobpacked 配置/bs/: { handler: storage-blobpacked, handlerArgs: { largeBlobs: /bs-packed/, metaIndex: { file: /home/you/var/perkeep/blobs/packed/packindex.leveldb, type: leveldb }, smallBlobs: /bs-loose/ } }若希望其他所有位置统一使用带复制的前缀可定义/bsrepl/为storage-replica把主存储与远端存储作为 backends/bsrepl/: { handler: storage-replica, handlerArgs: { backends: [ /bs/, /r1/ ] } }其中/r1/是另一台 Perkeep 实例的 blobserver通过storage-remote声明/r1/: { handler: storage-remote, handlerArgs: { url: https://example.com:3179, auth: userpass:foo:bar, skipStartupCheck: false } }storage-replica与storage-remote的更多参数如minWritesForSuccess、队列类型等可参考 pkg/blobserver/replica 与 config/dev-server-config.json 中/bs-recv/的用法。实操一份最小可运行的简单配置结合以上所有键一份覆盖认证、HTTPS、本地存储与 SQLite 索引的最小配置示例如下{ auth: userpass:alice:secret:localhost, listen: :3179, https: true, httpsCert: /etc/perkeep/fullchain.pem, httpsKey: /etc/perkeep/privkey.pem, baseURL: https://perkeep.example.com, identity: 2931A67C26F5ABDA, identitySecretRing: /home/alice/.config/perkeep/secring.gpg, blobPath: /home/alice/var/perkeep/blobs, packRelated: true, sqlite: /home/alice/var/perkeep/index.sqlite, shareHandler: true, runIndex: true, copyIndexToMemory: true }保存后执行perkeepd -configfile server-config.json即可启动若未指定-configfile默认使用$HOME/.config/perkeep/server-config.json不存在时自动生成默认配置。默认配置内容由WriteDefaultConfigFilegenconfig.go生成监听:3179、认证localhost、blobpacked 存储、SQLite 索引并自动创建 GPG 密钥环。启动后可通过http://localhost:3179/debug/config查看等价低级别配置用pk命令族cmd/pk管理 blob、索引与数据库最终形成一套贴合自身部署拓扑的 Perkeep 服务器配置方案。赞分享后端数据存储【免费下载链接】perkeepPerkeep (née Camlistore) is your personal storage system for life: a way of storing, syncing, sharing, modelling and backing up content.项目地址https://gitcode.com/gh_mirrors/pe/perkeep点击查看免费下载相关推荐PerKeep服务器配置详解从基础到高级PerKeep服务器配置详解从基础到高级 概述 PerKeep是一个分布式存储系统其服务器配置是系统运行的核心。本文将全面解析PerKeep服务器的配置方式后端数据存储终极指南XPrivacyLua 快速上手完整教程XPrivacyLua 是一款专为 Android 6.0 及以上版本设计的简易隐私管理工具通过向应用提供虚假数据而非真实数据来保护用户隐私完美解决了权限撤网络CLI简单ID服务器(SimpleIdServer)安装配置完全指南简单ID服务器 SimpleIdServer 安装配置完全指南 一、项目基础介绍与编程语言 简单ID服务器 SimpleIdServer 是一个开源框架旨在简后端安全上一篇猫抓浏览器资源嗅探完整指南从安装到 M3U8 下载只需四步下一篇PvZ Toolkit植物大战僵尸PC版开源修改工具深度解析与高级应用指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考