FAQ - 常見問題 | PreviewFile.dev

關於 PreviewFile.dev 功能、定價、安全性和技術實作的常見問題。

一般問題

什麼是 PreviewFile.dev？

PreviewFile.dev 是一個安全的檔案預覽服務，為 110+ 檔案格式生成短期、可自訂的預覽連結。無需暴露原始 URL 或要求下載即可分享 PDF、Office 文件、圖片、影片等。

→ 在開始使用中了解更多

支援哪些檔案格式？

我們支援 110+ 格式，包括：

文件：PDF、DOCX、PPTX、XLSX、TXT、MD
圖片：JPG、PNG、GIF、WebP、SVG、TIFF
影片：MP4、WebM、MOV、AVI
程式碼：JS、Python、Java、Go 和 50+ 語言
壓縮檔：ZIP、RAR、7z、TAR

→ 在支援格式查看完整清單

定價如何運作？

免費：100 預覽/月，15 分鐘 TTL
Pro：10,000 預覽/月，自訂浮水印，24 小時 TTL
團隊：100,000 預覽/月，白標，SSO
企業：無限制，SLA，專屬支援

→ 在定價比較方案

技術問題

如何生成預覽連結？

使用 REST API 以程式化方式建立預覽連結：

curl -X POST https://previewfile.dev/api/u \
  -H "x-api-key: $API_KEY" \
  -d '{"url": "https://example.com/file.pdf", "ttlMinutes": 60}'

→ 在API 文件查看完整指南

你們會儲存我的檔案嗎？

不會。 我們只快取元資料和縮圖。

→ 在安全政策了解我們的架構

可以用於敏感文件嗎？

可以。啟用這些安全功能：

時間限制連結：5 分鐘到 24 小時自動過期
浮水印：添加自訂文字疊加層
禁止下載模式：防止檔案下載
一次性連結：首次存取後過期

→ 在安全政策探索所有選項

連結過期時會發生什麼？

過期的連結會顯示「連結已過期」錯誤頁面。預覽元資料會自動從我們的資料庫中刪除，任何快取的縮圖會在 1 小時內清除。

可以在我的應用中嵌入預覽嗎？

可以。使用預覽 URL 的 <iframe>：

<iframe src="https://previewfile.dev/p/abc123" 
        width="100%" height="600px"></iframe>

團隊方案支援網域白名單，以限制嵌入的運作位置。

→ 在API 文件查看 API 詳細資訊

安全問題

我的原始 URL 會暴露嗎？

不會。收件人只看到短的預覽 URL（例如 previewfile.dev/p/abc123）。原始檔案 URL 永遠不會在瀏覽器或網路日誌中顯示。

浮水印如何運作？

浮水印使用 Canvas/GPU 疊加層在客戶端渲染。您可以自訂文字、位置和透明度。團隊方案支援自訂字體和標誌。

→ 在安全政策查看設定指南

可以按 IP 或引用者限制存取嗎？

可以（團隊+ 方案）。設定：

IP 白名單：只允許特定 IP
引用者限制：阻止熱連結
User-Agent 驗證：防止自動爬取

→ 在安全政策查看進階控制

你們符合 GDPR/HIPAA 嗎？

企業方案包括：

資料處理協議（DPA）
所有存取事件的稽核日誌
區域資料駐留選項
SOC 2 Type II 認證

聯絡銷售部門獲取合規文件。

產品問題

Free 和 Pro 有什麼差別？

功能	Free	Pro
每月預覽	100	10,000
最大 TTL	15 分鐘	24 小時
自訂浮水印	❌	✅
下載控制	✅	✅
一次性連結	✅	✅

→ 在定價查看完整比較

可以白標預覽頁面嗎？

可以（團隊+ 方案）。自訂：

自訂網域（preview.yourdomain.com）
品牌化標題/頁尾
自訂 CSS 主題
移除「Powered by PreviewFile」頁尾

聯絡銷售部門進行白標設定。

你們提供 API 速率限制嗎？

提供。按方案限制速率：

免費：100 請求/小時
Pro：1,000 請求/小時
團隊：10,000 請求/小時
企業：自訂限制

超過限制會回傳 HTTP 429 和 Retry-After 標頭。

→ 在API 文件查看 API 參考

可以獲得使用分析嗎？

可以。儀表板顯示：

生成的總預覽數
最常檢視的檔案
地理分佈
格式分析
過期模式

團隊方案包括 CSV 匯出和 Webhook 通知。

整合問題

你們支援哪些語言？

我們提供以下範例：

JavaScript/Node.js、Python、Java、C#、Go
Rust、PHP、Ruby、Swift、Kotlin

→ 在API 文件查看程式碼範例

可以與 AWS S3 / Google Cloud 一起使用嗎？

可以。從您的儲存提供者生成簽名 URL，然後傳遞給 PreviewFile：

const s3Url = await getSignedUrl(s3Client, getObjectCommand);
const preview = await fetch('/api/u', {
  body: JSON.stringify({ url: s3Url })
});

確保簽名 URL 比您的預覽 TTL 更長有效。

你們有 SDK 嗎？

官方 SDK 即將推出。目前使用 REST API 的標準 HTTP 客戶端。

→ 在GitHub Discussions請求 SDK

可以自己託管嗎？

企業方案包括使用 Docker/Kubernetes 清單的內部部署選項。聯絡銷售部門獲取授權。

故障排除

為什麼我的預覽顯示「不支援的格式」？

確認檔案副檔名與 MIME 類型匹配
檢查格式是否在支援格式中
確保原始 URL 可公開存取
嘗試使用正確的 MIME 類型重新上傳

預覽連結回傳 404

常見原因：

連結過期（檢查 expireAt 時間戳記）
一次性連結已存取
無效的短 URL（檢查拼寫錯誤）

影片/音訊預覽無法運作

確保：

檔案使用支援的編解碼器（建議 H.264/AAC）
原始伺服器發送正確的 Content-Type 標頭
CORS 標頭允許跨來源存取
檔案大小 < 500 MB 以獲得最佳效能

→ 在GitHub Issues回報問題

帳單問題

預覽如何計算？

每個成功的預覽生成（HTTP 200）計算為一個預覽。失敗的請求（4xx/5xx）不計算。

可以在月中升級嗎？

可以。您將按剩餘天數按比例收費，限制立即增加。

你們接受哪些付款方式？

信用卡/簽帳卡（Visa、Mastercard、Amex）
PayPal（團隊+ 方案）
發票/ACH（僅企業）

你們為非營利組織提供折扣嗎？

提供。非營利組織和教育機構在 Pro/團隊方案上享受 50% 折扣。聯絡銷售部門並提供身分證明。

還有問題嗎？

📧 電子郵件：[email protected]
💬 Discord：加入我們的社群
🐦 Twitter：@previewfile
📖 文件：瀏覽所有文件

FAQ - 常見問題

On this page