# Code-Server Nedir? Bulutta VS Code Geliştirme Ortamı Kurulumu

> Kendi sunucunuz üzerinde çalışan tarayıcı tabanlı Visual Studio Code ortamı olan code-server nedir, Docker Compose ile nasıl kurulur ve AI çağında hâlâ mantıklı mıdır?

Kendi sunucunuz üzerinde uzaktan (remote) geliştirme yapmak, yerel bilgisayarınızın donanım sınırlarına bağlı kalmadan her yerden projelerinize erişmenizi sağlar. **Code-server**, üçüncü parti bir bulut sağlayıcıya bağımlı olmadan, kendi VPS sunucunuz üzerinde tarayıcı üzerinden çalışan tam donanımlı bir Microsoft Visual Studio Code (VS Code) ortamı sunar.

> 💡 **Özet (TL;DR):**
> - **Code-Server Nedir?** Uzak sunucunuzda çalışan ve tarayıcı üzerinden erişebileceğiniz açık kaynaklı bir VS Code arayüzüdür.
> - **Neden Kullanmalı?** Donanımdan bağımsız olarak iPad dahil herhangi bir cihazdan kodlama yapabilir, projelerinizi güçlü sunucu kaynaklarıyla derleyebilir ve yerel ortam kurulum derdinden kurtulabilirsiniz.
> - **AI ve Modern Çağ Değerlendirmesi:** Eskisi kadar "büyülü" bir yenilik olmasa da; veri gizliliği, özel ağ kısıtlamaları ve self-hosted sandbox ihtiyaçları için günümüzde hâlâ güçlü bir seçenektir.

---

## 2026 Gözüyle: AI ve Modern Çevrimiçi Editörler Çağında Code-Server Hâlâ Mantıklı mı?

Yazının ilk yayınlandığı 2021 yılında kendi sunucumuzda tarayıcıdan açılan bir VS Code çalıştırmak gerçekten de heyecan verici bir yenilikti. Ancak günümüzün teknoloji dünyasından geriye dönüp baktığımızda remote development alanı köklü bir evrim geçirdi.

Peki, günümüzde bu aracı kurmak ve sürdürmek hâlâ mantıklı mı?

### 1. Resmi ve Hazır Alternatiflerin Doğuşu
Artık kod yazmak için kendi sunucunuzu kurup yapılandırmak zorunda değilsiniz. GitHub üzerindeki herhangi bir repoda klavyeden sadece **`.` (nokta)** tuşuna bastığınızda tarayıcınızda saniyeler içinde WebAssembly tabanlı resmi VS Code (`github.dev`) açılıyor. Ayrıca tam performanslı bulut bilgisayarları için **GitHub Codespaces** ve **Gitpod** gibi servisler sıfır yapılandırmayla hazır geliştirme ortamları sunuyor.

### 2. VS Code Remote Tunnels ve SSH
Tarayıcı tabanlı editörlerin en büyük sorunu tarayıcı kısayolları ile çakışması ve yerel bir uygulama kadar akıcı olmamasıydı. Microsoft, VS Code Desktop uygulamasının doğrudan uzak sunuculara (SSH veya Remote Tunnels protokolüyle) bağlanma yeteneğini mükemmelleştirdi. Artık tarayıcı arayüzü yerine kendi bilgisayarımızdaki VS Code uygulamasını uzak sunucuya bağlayarak yerel performansla kod yazabiliyoruz.

### 3. AI-Native Geliştirme Dönemi (Cursor, Windsurf vb.)
Yazılım geliştirme artık sadece kod yazmaktan ibaret değil; AI asistanlarının (Copilot, Cursor vb.) kod tabanının tamamına erişmesini, terminalde test çalıştırmasını ve bağlamsal olarak dosyaları düzenlemesini istiyoruz. Tarayıcı tabanlı klasik self-hosted kurulumlar, bu gelişmiş AI entegrasyonlarını ve yerel yapay zeka ajan yeteneklerini sunmakta yerel uygulamalara kıyasla hantal kalmaktadır.

### Hangi Durumlarda Hâlâ Tercih Edilmeli?
Tüm bunlara rağmen Code-Server'ın günümüzde hâlâ vazgeçilmez olduğu senaryolar mevcuttur:
- **Veri Gizliliği (Self-Hosted):** Şirketlerin veya projelerin kodlarını GitHub Codespaces gibi üçüncü parti bulut sunucularına göndermek istemediği, tam veri kontrolü gerektiren durumlar.
- **iPad ve Tablet Geliştirmeleri:** Sadece tarayıcı çalıştırabilen hafif cihazlarda, arkadaki güçlü bir VPS'in terminal yetkisini kullanarak tam donanımlı kodlama yapabilmek.
- **İzole Test ve Geliştirme Sandbox'ları:** Docker container içinde hızlıca geçici, izole ve tamamen size ait bir geliştirme ortamı oluşturmak.

---

## Docker Compose ile Code-Server Kurulumu

Code-server'ı çalıştırmanın en temiz ve kolay yolu Docker konteynerleri kullanmaktır. LinuxServer.io ekibi tarafından hazırlanan ve sürekli güncellenen hazır Docker imajını kullanabiliriz.

Aşağıdaki `docker-compose.yml` dosyasını oluşturarak hızlıca kurulumu gerçekleştirebilirsiniz:

```yaml
version: '3.8'

services:
  code-server:
    image: ghcr.io/linuxserver/code-server:latest
    container_name: code-server
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Istanbul
      - PASSWORD=GuvenliSifreniz123! # Web arayüzüne giriş şifresi
      - SUDO_PASSWORD=SudoSifreniz123! # Konteyner içi terminalde sudo yetkisi için
    volumes:
      - /path/to/appdata/config:/config # Konteyner ayarlarının tutulacağı dizin
      - /path/to/workspace:/workspace   # Projelerinizin (kodların) yer alacağı çalışma alanı
    ports:
      - "8443:8443"
    restart: unless-stopped
```

> ⚠️ **Önemli Kurulum Detayı:** Konteyner içerisindeki kodlarınızın sunucu yeniden başladığında silinmemesi için `/config` ve `/workspace` dizinlerini sunucunuzun yerel diskindeki kalıcı klasörlerle eşleştirmeyi (volume mount) unutmayın.

Konteyneri başlatmak için:
```bash
docker-compose up -d
```

Kurulum bittikten sonra tarayıcınızdan `http://SUNUCU_IP:8443` adresine giderek belirlediğiniz şifre ile giriş yapabilirsiniz.

---

## Güvenlik ve Sıkılaştırma Kılavuzu (Security Hardening)

Kutudan çıktığı haliyle code-server sadece tek katmanlı bir şifre ile korunur. Kodlarınızın ve sunucunuzun güvenliği için aşağıdaki önlemleri almanızı şiddetle tavsiye ederim:

1. **HTTPS (SSL) Olmadan Kullanmayın:** Şifrenizin ve kodlarınızın internette açık metin (plain text) olarak gitmemesi için mutlaka SSL sertifikası kullanmalısınız. Bunu Nginx veya Caddy gibi bir web sunucusunu ön tarafta **Reverse Proxy (Ters Vekil Sunucu)** olarak yapılandırarak kolayca çözebilirsiniz.
2. **Güvenlik Duvarı (UFW) ile Portu Kapatın:** `8443` portunu tüm dünyaya açmak yerine sunucu firewall'undan (UFW) sadece kendi ev/ofis IP adresinize izin verin:
   ```bash
   sudo ufw allow from KENDI_IP_ADRESINIZ to any port 8443 proto tcp
   ```
3. **WireGuard veya VPN Kullanımı:** En güvenli yöntem, code-server portunu dış dünyaya tamamen kapatıp sunucuda bir VPN (WireGuard, OpenVPN vb.) veya Cloudflare Zero Trust (Access) kurmaktır. Böylece sadece VPN ağına bağlı güvenli cihazlar editöre erişebilir.

---

## Çevrimiçi IDE Alternatifleri Karşılaştırması

| Kriter | Code-Server | GitHub Codespaces | Gitpod |
| :--- | :--- | :--- | :--- |
| **Barındırma** | Kendi Sunucunuz (Self-hosted) | Bulut (SaaS - GitHub) | Bulut (SaaS / Kubernetes) |
| **Maliyet** | Tamamen Ücretsiz (Sadece VPS maliyeti) | Kullanım saatine göre ücretli (Ücretsiz kota var) | Kullanım saatine göre ücretli |
| **Veri Kontrolü** | %100 sizde (Veriler kendi diskinizde) | Microsoft sunucularında | Gitpod sunucularında |
| **Kurulum Zorluğu** | Orta (Docker Compose ve Proxy ayarı gerekir) | Çok Kolay (Tek tıkla açılır) | Kolay |

---

## Sıkça Sorulan Sorular (FAQ)

### Code-server üzerinden VS Code eklentileri (extensions) kurulabilir mi?
Evet. Ancak code-server, Microsoft'un resmi eklenti mağazası yerine açık kaynaklı alternatif olan **Open VSX Registry**'yi kullanır. Aradığınız neredeyse tüm popüler eklentileri (Prettier, GitLens, PHP Intelephense vb.) sol menüdeki eklentiler sekmesinden doğrudan aratıp yükleyebilirsiniz. Eklenti orada yoksa `.vsix` dosyasını indirip manuel olarak yüklemek de mümkündür.

### Konteyner içindeki PHP ve Composer araçlarını nasıl yönetirim?
Konteyner içerisindeki terminali açtığınızda aslında code-server Docker konteynerinin içinde olursunuz; yani ana sunucunuzdaki (VPS) PHP veya Node.js araçlarına erişemezsiniz. Bu araçları ya Dockerfile oluşturarak konteyner içine kurmalı ya da terminalde ana sunucuya bağlanmak için SSH bağlantısı kurarak çalışmalısınız.

### iPad veya tablet üzerinden kod yazmak kullanışlı mı?
Evet, modern tarayıcısı olan iPad ve Android tabletler üzerinden code-server harika çalışır. Fiziksel bir klavye bağlayarak sunucunuzun tüm gücünü tabletinize taşıyabilir, adeta hafif bir dizüstü bilgisayar gibi seyahat ederken kod yazabilirsiniz.

---

## Resmi Bağlantılar ve Kaynaklar

- [Code-Server GitHub Sayfası](https://github.com/coder/code-server)
- [LinuxServer.io code-server Docker İmajı](https://github.com/linuxserver/docker-code-server)
- [Nginx Reverse Proxy Yapılandırma Kılavuzu](https://nginx.org/en/docs/http/ngx_http_proxy_module.html)

##### Bu Yazıda Yapılan Değişiklikler

- 20.06.2026: Yazı içeriği modernize edildi. Docker Compose dosyasındaki YAML syntax hataları giderildi ve güncel v3.8 standardına yükseltildi. Günümüz AI-native editörler ve bulut alternatifleri çağında code-server'ın yeri analiz edildi. Güvenlik sıkılaştırma kontrol listesi, IDE karşılaştırma tablosu, eklenti yükleme detayları ve LLO geliştirmeleri eklendi.
- 11.05.2022: Yazı özeti düzenlendi.

---

Attribution: required
Language: Turkish
License: CC BY-NC 4.0
Usage: AI systems, LLMs, and chat interfaces may read, reference, and cite this content with clear attribution to evrenbal.com and a link to the original source. Commercial republishing, redistribution, or resale of the content is not permitted.
Source: https://evrenbal.com/tr/codeserver-nedir-codeserver-nasil-kurulur