# Yükleme Kaynağı

> Başka bir yeri olmayan dokümantasyon için panoya dosya, klasör ve arşiv sürüklemek, ve bunun sınırları.

- Güncelleme: 2026-09-21
- Kaynak: https://contextator.com/tr/docs/upload-source/
- Dil: tr-TR
- Yazar: Muhammet Şafak

---
Sunucuda olmayan ve bir depoda olmayan dokümantasyon: panoya sürükleyin. Dosyalar, yapılarıyla birlikte
tüm klasörler ve arşivler sunucu tarafında açılır ve saklanır.

Bu, birinin size e-postayla gönderdiği bir zip, başka bir araçtan bir export, ya da dizüstünüzde başka
bir yeri olmayan bir klasör için doğru kaynaktır.

## Bir tane eklemek

**Add source → Upload files**

| Alan | Notlar |
|-------|-------|
| **Name** | Mount öneki. Değiştirilemez |
| **Content type** | `Plain Markdown / text`, bir Notion *Export → Markdown & CSV* zip'i için `Notion export`, ya da yüklenen spesifikasyonlar için `OpenAPI / Swagger` |
| **File types** | Varsayılan olarak `.md` ve `.mdx`; `.txt`, `.html`/`.htm`, `.csv`, `.docx` ve `.pdf` de seçilebilir — yüklemedeki başka her şey düşürülür |

Sonra dosyaları dropzone'a sürükleyin, ya da **Choose folder** / **Choose files**'ı kullanın. Klasörler
yapılarını korur. İlerleme dosya başına gösterilir, ve büyük klasörler otomatik olarak birkaç isteğe
bölünür.

Son olarak yüklemenin nasıl uygulanacağını seçin:

| Mod | Etki |
|------|------|
| **Add to existing files** | Kaynağın zaten tuttuğuyla birleştirir; aynı yoldaki dosyaların üzerine yazılır |
| **Replace all files** | Kaynağın içeriği, tam olarak yüklediğiniz şey olur |

Kaydetmek yüklemeyi işler ve bir indeksleme çalıştırmasını kuyruğa alır.

## Arşivler

`.zip`, `.tar`, `.tar.gz` / `.tgz` ve `.rar` sunucuda açılır. Çıkarma kasıtlı olarak sıkıdır:

- hedefin dışına kaçacak girdiler reddedilir;
- gizli klasörler (`.git/`, `.obsidian/`, …) düşürülür;
- platformlar arasında taşınabilir olmayan adlar reddedilir;
- kaynağın indekslemediği uzantıdaki dosyalar atlanır;
- girdi sayısı ve toplam boyut sınırlandırılır (`ARCHIVE_MAX_ENTRIES`, `ARCHIVE_MAX_TOTAL_BYTES`);
- arşivin içindeki arşivler bir seviye açılır — bu, bir Notion export'unun ihtiyaç duyduğu şeydir,
  çünkü zip'in içinde `Part-1.zip` gönderir.

Atlanan her şey sessizce düşürülmek yerine size raporlanır, böylece tam olarak neyin alınıp neyin
alınmadığını görebilirsiniz.

## Dosyaları yönetmek

Bir upload kaynağı satırındaki **Files**, kaynağın şu anda ne tuttuğunu listeler. Tek tek dosyalar
oradan silinebilir, bu da projeyi yeniden indeksler.

Dosyalar, konteynerin içinde `DATA_DIR` altında (varsayılan olarak `/data`), o kaynağa ait bir
klasörde yaşar. Kaynakla ve projeyle birlikte silinirler — nasıl yedekleneceği için bkz.
[Yedekleme ve Veri](/tr/docs/backup-and-data/).

> Bir upload kaynağı, içeriğinin **tek kopyasıdır**. Bir git kaynağının (yeniden klonlanabilir) ya da
> bir Notion kaynağının (yeniden çekilebilir) aksine, silinen bir upload kaynağının dosyaları gider.
> `contextator-data` volume'unu yedeklerinize dahil edin.

## Güncel tutmak

Senkronize edilecek bir şey yoktur — içerik değiştiğinde, **Add** ya da **Replace** seçerek yeniden
yükleyin.

Aynı içerik bir depoda ya da sunucuda da yaşıyorsa, bunun yerine bir
[git kaynağı](/tr/docs/git-repository-source/) ya da bir
[yerel klasör](/tr/docs/local-directory-source/) tercih edin: ikisi de kendini günceller.

## Sınırlar

| Ayar | Varsayılan |
|---------|---------|
| `UPLOAD_MAX_FILE_BYTES` | Dosya başına 50 MB |
| `UPLOAD_MAX_FILES_PER_REQUEST` | İstek başına 500 dosya (pano daha büyük klasörleri böler) |
| `UPLOAD_MAX_ARCHIVE_BYTES` | Arşiv başına 256 MB |
| `ARCHIVE_MAX_ENTRIES` | 20.000 girdi |
| `ARCHIVE_MAX_TOTAL_BYTES` | Açıldığında 1 GB |

Hepsi yapılandırılabilir — bkz. [Yapılandırma](/tr/docs/configuration/).

## Bir vault ya da export yüklemek

- **Obsidian vault** — özel *Obsidian vault* sekmesini kullanın; bu, doğru content type'ı zaten seçili
  bir upload kaynağıdır. Bkz. [Obsidian Vault'ları](/tr/docs/obsidian-vaults/).
- **Notion export zip'i** — content type olarak **Notion export** ile *Upload files*'ı kullanın; bu,
  Notion'ın her dosya ve klasör adına eklediği 32 karakterlik sayfa id'lerini temizler. Bkz.
  [İçerik Türleri](/tr/docs/content-types/).