PerKeep服务器配置详解：从基础到高级

PerKeep服务器配置详解：从基础到高级

perkeep Perkeep (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服务器配置文件默认位于$HOME/.config/perkeep/server-config.json，采用JSON格式。配置文件支持两种模式：

1. 简单模式：适合基础配置需求
2. 低层模式：提供更细粒度的控制能力

简单模式配置详解

核心配置项

1. 认证机制(auth)：

   • none：无认证
   • localhost：仅接受本地连接
   • userpass:用户名:密码：HTTP基本认证
   • tailscale:ARG：通过Tailscale网络认证

2. 网络配置：

   • baseURL：服务器基础URL（用于反向代理场景）
   • listen：监听地址和端口
   • https：HTTPS相关配置，包括证书路径和自动获取Let's Encrypt证书

3. 身份认证：

   • identity：GPG指纹
   • identitySecretRing：GnuPG密钥环文件路径

存储配置

PerKeep支持多种存储后端：

1. 内存存储：

   "memoryStorage": true
   

   仅用于开发和调试

2. 本地磁盘存储：

   "blobPath": "/path/to/storage"
   

3. 云存储：

   • S3："s3": "credentialKey:secureKey:bucketName[/path][:hostname]"
   • Backblaze B2："b2": "credentialKey:secureKey:bucketName[/path]:hostname"
   • Google Cloud Storage："googlecloudstorage": "clientId:clientSecret:refreshToken:bucketName[/path]"

4. 存储优化选项：

   • packRelated：自动重新打包以提高读取速度
   • packBlobs：使用diskpacked存储提高写入吞吐量

索引配置

1. 索引后端：

   • SQLite："sqlite": "/path/to/db"
   • LevelDB："levelDB": "/path/to/db"
   • MongoDB："mongo": "user:password@host"
   • MySQL："mysql": "user@host:password"
   • PostgreSQL："postgres": "user@host:password"
   • 内存索引："memoryIndex": true

2. 数据库选项：

   • dbname：数据库名称
   • dbUnique：区分多个PerKeep实例的唯一标识

发布配置

PerKeep支持通过模板发布内容：

"publish": {
  "/pics/": {
    "camliRoot": "mypics",
    "cacheRoot": "/path/to/cache",
    "goTemplate": "gallery.html"
  }
}

导入器

PerKeep内置多种数据导入器，包括：

• RSS/Atom/RDF订阅
• Flickr
• Foursquare
• Picasa
• Pinboard
• Twitter
• Instapaper

通过访问/importer/路径进行配置。

Windows特殊配置

在Windows环境下，建议使用MySQL而非SQLite作为索引后端：

1. 安装MariaDB或MySQL
2. 修改配置文件：

   {
     "dbname": "camliprod",
     "mysql": "user@localhost:password"
   }
   

3. 使用pk dbinit命令初始化数据库

低层模式配置

当简单模式无法满足需求时，可以使用低层模式配置。建议通过以下步骤获取低层配置：

1. 先用简单模式运行PerKeep
2. 访问/debug/config获取当前配置的低层表示
3. 基于此进行修改

高级功能示例：复制到其他实例

"/bsrepl/": {
  "handler": "storage-replica",
  "handlerArgs": {
    "backends": [
      "/bs/",
      "/r1/"
    ]
  }
}

其中/r1/可以配置为远程存储：

"/r1/": {
  "handler": "storage-remote",
  "handlerArgs": {
    "url": "https://remote.example.com:3179",
    "auth": "userpass:foo:bar"
  }
}

最佳实践

1. 生产环境务必启用HTTPS
2. 根据数据量选择合适的存储后端
3. 定期备份索引数据库
4. 在反向代理场景下正确配置baseURL
5. 测试环境可以使用内存存储，但生产环境应使用持久化存储

通过本文的详细解析，您应该能够根据实际需求灵活配置PerKeep服务器，无论是简单的个人使用场景还是复杂的企业级部署。

perkeep Perkeep (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