ghcr.io/caramelfur/picsur:0.3.1

Beta

目前该软件仍处于 beta 阶段，许多功能尚不完善，未来可能会有变更。但它已经可以正常运行，欢迎尝试。

Demo

你可以通过以下链接查看实时演示：[***]

图片每五分钟删除一次，最大文件大小为 16MB。不过这应该能让你了解它的工作方式。

Features

以下是已完成功能和计划功能的列表。更详细的列表可访问项目主页查看。

此处标记的所有功能在最新版本中均应可用。

• 上传和查看图片 上传和查看图片

• ***上传 ***上传

• 用户账户 用户账户

• 用户角色和权限 用户角色和权限

• 适当的 CORS 限制 适当的 CORS 限制

• Exif 数据剥离 Exif 数据剥离

• 保留原始图片的功能 保留原始图片的功能

• 支持多种格式 QOI JPG PNG WEBP（支持动画）TIFF HEIF BMP GIF（支持动画）JPG-XL JPG-2000 支持多种格式

• QOI

• JPG

• PNG

• WEBP（支持动画）

• TIFF

• HEIF

• BMP

• GIF（支持动画）

• JPG-XL

• JPG-2000

• 图片转换 图片转换

• 图片编辑 调整大小 旋转 翻转 剥离透明度 反色 灰度 图片编辑

• 调整大小

• 旋转

• 翻转

• 剥离透明度

• 反色

• 灰度

• 可删除图片 可删除图片

• 完善的数据库迁移 完善的数据库迁移

• 在列表中显示自己的图片 在列表中显示自己的图片

• 聊天中的正确预览 聊天中的正确预览

• 过期图片 过期图片

• ShareX 端点 ShareX 端点

• ARM64 和 AMD64 Docker 镜像 ARM64 和 AMD64 Docker 镜像

• 白色模式 白色模式

• 公共图库 公共图库

• 相册 相册

Bugs

如果遇到任何错误或异常，请在此提交 issue。因为没有反馈，我永远不会知道它们的存在。

Star

如果你喜欢这个项目，别忘了给它点个 star。这让我知道我没有在人们不喜欢的东西上浪费时间。

Faq

这个项目还在维护吗？

不，不再维护了。我实在没有时间和精力。一旦开始正常工作，时间过得飞快，这真的很令人惊讶。

欢迎 fork 它并继续我未完成的工作。如果有人想完全接管这个项目，也请 fork 并用心维护，然后联系我。

也许将来我会抽出一些时间继续这个项目，但不确定。

为什么我的图片会从公共实例中消失？

公共实例仅作为演示，因此图片仅保留 5 分钟。这是为了防止服务器磁盘空间耗尽，以及防止有人用它托管有问题的图片。

如果你希望保留图片，必须自行托管实例。

如何允许用户注册自己的账户？

默认情况下，用户无法注册自己的账户。这是为了防止用户意外允许任何人上传到他们的实例。

不过你可以启用用户注册。为此，需进入 settings -> roles -> guest -> edit，然后为访客角色授予 Register 权限。保存角色后，登录页面将显示注册按钮。

我想保留原始图片文件，该怎么做？

默认情况下，Picsur 不会保留原始图片文件。因为在大多数情况下这不是必需的，且能节省磁盘空间。

但如果你想启用此功能，可以进入 settings -> general，然后启用 Keep original 选项。保存设置后，原始文件将被保留。

请注意，原始图片的 exif 数据不会被移除。因此请确保不要意外分享敏感数据。

该服务说支持 QOI 格式，这是什么？

QOI 是一种新的无损图像格式，设计目标是编码和解码速度极快，同时仍能提供良好的压缩率。这是服务器上传图片时将存储的主要格式。

你可以在此处了解更多关于 QOI 的信息。

默认管理员登录信息是什么？

默认用户名为 admin，默认密码由 PICSUR_ADMIN_PASSWORD 环境变量设置。

我遇到“复制到剪贴板失败”的问题

只有在 HTTPS 网站或 localhost 上才能使用剪贴板功能。请确保你通过 HTTPS 运行 Picsur。

自行托管实例

你可以通过 Docker 轻松自行运行此服务。以下是一个 docker-compose 文件示例：

version: '3'
services:
  picsur:
    image: ghcr.io/caramelfur/picsur:latest
    container_name: picsur
    ports:
      - '8080:8080'
    environment:
      # PICSUR_HOST: '0.0.0.0'
      # PICSUR_PORT: 8080

      PICSUR_DB_HOST: picsur_postgres
      # PICSUR_DB_PORT: 5432
      # PICSUR_DB_USERNAME: picsur
      # PICSUR_DB_PASSWORD: picsur
      # PICSUR_DB_DATABASE: picsur

## 默认用户名为 admin，不可修改
      # PICSUR_ADMIN_PASSWORD: picsur

## 可选，未设置则生成随机密钥
      # PICSUR_JWT_SECRET: CHANGE_ME
      # PICSUR_JWT_EXPIRY: 7d

## 上传文件的最大接受大小（字节）
      # PICSUR_MAX_FILE_SIZE: 128000000

## 无需修改，除非使用自定义前端
      # PICSUR_STATIC_FRONTEND_ROOT: "/picsur/frontend/dist"

## 警告：详细模式可能会记录敏感数据
      # PICSUR_VERBOSE: "true"
    restart: unless-stopped
  picsur_postgres:
    image: postgres:17-alpine
    container_name: picsur_postgres
    environment:
      POSTGRES_DB: picsur
      POSTGRES_PASSWORD: picsur
      POSTGRES_USER: picsur
    restart: unless-stopped
    volumes:
      - picsur-data:/var/lib/postgresql/data
volumes:
  picsur-data:

Thanks

• @aldumil 曾*** 5 ***
• @mcmastererp 从 2024 年 3 月至 2024 年 10 月每月*** 2 ***
• @gander 从 2024 年 3 月至 2024 年 11 月每月*** 5 ***
• @TheSameCat2 从 2023 年 11 月至 2024 年 5 月每月*** 5 ***
• @LordCrashWire 曾*** 20 ***
• @chennin 从 2023 年 6 月至 2024 年 9 月每月*** 4 ***
• @awg13 曾*** 10 ***

Api

以下是通常保持最新的 API 文档：

如果你想为 Picsur 构建自己的前端或应用，这肯定会派上用场。也可以查看源代码中的 ./shared 文件夹，其中包含 API 的 TypeScript 模式定义。

目前此软件仍处于测试阶段（beta），许多功能尚不完善，未来可能会有变更。但它确实可以正常运行，欢迎尝试使用。

Demo

你可以在此查看实时演示：

图片每五分钟删除一次，最大文件大小为16MB。但这应该能让你了解它的工作方式。

Features

以下是已完成功能和计划功能的列表。更详细的列表可访问https://github.com/CaramelFur/Picsur/projects/1%E3%80%82%E6%AD%A4%E5%A4%84%E6%A0%87%E8%AE%B0%E7%9A%84%E6%89%80%E6%9C%89%E5%8A%9F%E8%83%BD%E5%9C%A8%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%E4%B8%AD%E5%9D%87%E5%BA%94%E5%8F%AF%E7%94%A8%E3%80%82

• 图片上传和查看

• ***上传

• 用户账户

• 用户角色和权限

• 适当的CORS限制

• EXIF数据剥离

• 保留原始图片的功能

• 支持多种格式

  • QOI
  • JPG
  • PNG
  • WEBP（支持动图）
  • TIFF
  • HEIF
  • BMP
  • GIF（支持动图）
  • JPG-XL
  • JPG-2000

• 图片转换

• 图片编辑

  • 调整大小
  • 旋转
  • 翻转
  • 剥离透明度
  • 反色
  • 灰度

• 图片删除功能

• 完善的数据库迁移

• 在列表中显示自己的图片

• 聊天中的正确预览

• 图片过期功能

• ShareX端点

• ARM64和AMD64 Docker镜像

• 白色模式

• 公共图库

• 相册

Bugs

如果遇到任何错误或异常，请在https://github.com/CaramelFur/Picsur/issues%E6%8F%90%E4%BA%A4issue%E3%80%82%E5%9B%A0%E4%B8%BA%E6%B2%A1%E6%9C%89%E5%8F%8D%E9%A6%88%EF%BC%8C%E6%88%91%E6%B0%B8%E8%BF%9C%E4%B8%8D%E4%BC%9A%E7%9F%A5%E9%81%93%E5%AE%83%E4%BB%AC%E7%9A%84%E5%AD%98%E5%9C%A8%E3%80%82

Star

如果你喜欢这个项目，别忘了给它点个星标（Star）。这能让我知道我没有在人们不喜欢的事情上浪费时间。

Faq

此项目是否仍在维护？

不，不再维护了。我实在没有时间和精力。一旦开始正常工作，时间过得飞快，这真的很令人惊讶。欢迎Fork项目并继续我未完成的工作。如果有人想完全接管这个项目，也请Fork并投入精力，之后可以联系我。也许未来我会找到一些空闲时间继续这个项目，但不确定。

为什么我的图片在公共实例中消失了？

公共实例仅作为演示，因此图片仅保留5分钟。这是为了防止服务器磁盘空间耗尽，并防止有人使用它托管有问题的图片。如果希望保留图片，你需要自行部署实例。

如何允许用户自行注册账户？

默认情况下，用户无法自行注册账户。这是为了防止用户意外允许任何人上传到他们的实例。但如果你希望允许注册，可以进行如下操作：进入settings -> roles -> guest -> edit，然后为访客角色授予Register权限。保存角色后，登录页面将显示注册按钮。

我想保留原始图片文件，该怎么做？

默认情况下，Picsur不会保留原始图片文件。因为大多数情况下不需要原始文件，这样可以节省磁盘空间。但如果你想启用此功能，可以进入settings -> general，然后启用Keep original选项。保存设置后，原始文件将被保留。请注意，原始图片的EXIF数据不会被删除。因此请确保不会意外分享敏感数据。

此服务支持QOI格式，这是什么？

QOI是一种新的无损图像格式，设计初衷是实现极快的编码和解码速度，同时提供良好的压缩率。这是服务器上传图片时的主要存储格式。你可以在此处了解更多关于QOI的信息。

默认管理员登录信息是什么？

默认用户名为admin，默认密码由PICSUR_ADMIN_PASSWORD环境变量设置。

我遇到“复制到剪贴板失败”的问题

剪贴板功能仅能在HTTPS网站或localhost上使用。请确保你通过HTTPS运行Picsur。

Running your own instance

你可以通过Docker轻松自行运行此服务。以下是一个docker-compose示例文件：

version: '3'
services:
picsur:
image: ghcr.io/caramelfur/picsur:latest
container_name: picsur
ports:
- '8080:8080'
environment:
# PICSUR_HOST: '0.0.0.0'
# PICSUR_PORT: 8080

PICSUR_DB_HOST: picsur_postgres
# PICSUR_DB_PORT: 5432
# PICSUR_DB_USERNAME: picsur
# PICSUR_DB_PASSWORD: picsur
# PICSUR_DB_DATABASE: picsur

## The default username is admin, this is not modifiable
# PICSUR_ADMIN_PASSWORD: picsur

## Optional, random secret will be generated if not set
# PICSUR_JWT_SECRET: CHANGE_ME
# PICSUR_JWT_EXPIRY: 7d

## Maximum accepted size for uploads in bytes
# PICSUR_MAX_FILE_SIZE: 128000000
## No need to touch this, unless you use a custom frontend
# PICSUR_STATIC_FRONTEND_ROOT: "/picsur/frontend/dist"

## Warning: Verbose mode might log sensitive data
# PICSUR_VERBOSE: "true"
restart: unless-stopped
picsur_postgres:
image: postgres:17-alpine
container_name: picsur_postgres
environment:
POSTGRES_DB: picsur
POSTGRES_PASSWORD: picsur
POSTGRES_USER: picsur
restart: unless-stopped
volumes:
- picsur-data:/var/lib/postgresql/data
volumes:
picsur-data:

Thanks

• @aldumil 曾5
• @mcmastererp 2024年3月至2024年10月每月2
• @gander 2024年3月至2024年11月每月5
• @TheSameCat2 2023年11月至2024年5月每月5
• @LordCrashWire 曾20
• @chennin 2023年6月至2024年9月每月4
• @awg13 曾10

Api

以下是通常保持更新的API文档：

如果你希望为Picsur构建自己的前端或应用，这肯定会派上用场。另外，查看源代码中的./shared文件夹，其中包含API的TypeScript模式定义。