---
title: "Mengelola berkas statis (sebagai contoh gambar, JavaScript, CSS)"
version: 3.2
locale: id
source: https://docs.djangoproject.com/id/3.2/howto/static-files/
canonical: https://djangodocs.dev/id/3.2/howto/static-files/
---
# Mengelola berkas statis (sebagai contoh gambar, JavaScript, CSS)

Situs jaringan pada umumnya butuh melayani tambahan berkas-berkas seperti gambar, JavaScript, atau CSS. Di Django, kami mengacu pada berkas-berkas ini sebagai "berkas-berkas tetap". Django menyediakan [`django.contrib.staticfiles`](/id/3.2/ref/contrib/staticfiles/#module-django.contrib.staticfiles) untuk membantu anda mengelola mereka.

Halaman ini menggambarkan bagaimana anda dapat melayani berkas statis ini.

## Mengkonfigurasi berkas-berkas tetap

1. Pastikan bahwa `django.contrib.staticfiles` disertakan dalam [`INSTALLED_APPS`](/id/3.2/ref/settings/#std-setting-INSTALLED_APPS) anda.
2. Di berkas pengaturan anda, tentukan [`STATIC_URL`](/id/3.2/ref/settings/#std-setting-STATIC_URL), sebagai contoh:

   ```
   STATIC_URL = '/static/'
   ```
3. Dalam cetakan anda, gunakan etiket cetakan [`static`](/id/3.2/ref/templates/builtins/#std-templatetag-static) untuk membangun URL untuk jalur berhubungan yang diberikan menggunakan [`STATICFILES_STORAGE`](/id/3.2/ref/settings/#std-setting-STATICFILES_STORAGE) yang dikonfigurasi.

   ```html+django
   {% load static %}
   <img src="{% static 'my_app/example.jpg' %}" alt="My image">
   ```
4. Simpan berkas tetap di pelipat disebut `static` di aplikasi anda. Sebagai contoh `my_app/static/my_app/example.jpg`.

> **Melayani berkas-berkas**
>
> Dalam tambahan pada langkah-langkah konfigurasi ini, anda akan juga butuh untuk melayani berkas-berkas tetap.
>
> Selama pengembangan, jika anda menggunakan [`django.contrib.staticfiles`](/id/3.2/ref/contrib/staticfiles/#module-django.contrib.staticfiles), ini akan dilakukan otomatis oleh [`runserver`](/id/3.2/ref/django-admin/#django-admin-runserver) ketika [`DEBUG`](/id/3.2/ref/settings/#std-setting-DEBUG) disetel ke `True` (lihat [`django.contrib.staticfiles.views.serve()`](/id/3.2/ref/contrib/staticfiles/#django.contrib.staticfiles.views.serve)).
>
> Cara ini adalah **terlalu tidak efesien** dan mungkin **tidak aman**, jadi dia **tidak cocok untuk produksi**.
>
> Lihat [menyebarkan berkas tetap](/id/3.2/howto/static-files/deployment/) untuk strategi yang sesuai untuk melayani berkas-berkas tetap dalam lingkungan produksi.

Proyek anda mungkin juga mempunyai aset tetap yang tidak diikat pada aplikasi khusus. Dalam tambahan untuk menggunakan direktori `static/` didalam aplikasi anda, anda dapat menentukan sebuah daftar direktori ([`STATICFILES_DIRS`](/id/3.2/ref/settings/#std-setting-STATICFILES_DIRS))  di berkas pengaturan anda dimana Django akan juga mencari untuk berkas-berkas tetap. Sebagai contoh:

```
STATICFILES_DIRS = [
    BASE_DIR / "static",
    '/var/www/static/',
]
```

Lihat dokumentasi untuk pengaturan [`STATICFILES_FINDERS`](/id/3.2/ref/settings/#std-setting-STATICFILES_FINDERS) untuk rincian pada bagaimana `staticfiles` menemukan berkas-berkas anda.

> **Namespacing berkas statis**
>
> Now we *might* be able to get away with putting our static files directly
> in `my_app/static/` (rather than creating another `my_app`
> subdirectory), but it would actually be a bad idea. Django will use the
> first static file it finds whose name matches, and if you had a static file
> with the same name in a *different* application, Django would be unable to
> distinguish between them. We need to be able to point Django at the right
> one, and the best way to ensure this is by *namespacing* them. That is,
> by putting those static files inside *another* directory named for the
> application itself.
>
> You can namespace static assets in [`STATICFILES_DIRS`](/id/3.2/ref/settings/#std-setting-STATICFILES_DIRS) by
> specifying [prefixes](/id/3.2/ref/settings/#staticfiles-dirs-prefixes).

## Melayani berkas-berkas tetap selama pengembangan

Jika anda menggunakan [`django.contrib.staticfiles`](/id/3.2/ref/contrib/staticfiles/#module-django.contrib.staticfiles) seperti yang dijelaskan diatas, [`runserver`](/id/3.2/ref/django-admin/#django-admin-runserver) akan melakukan ini secara otomatis ketika [`DEBUG`](/id/3.2/ref/settings/#std-setting-DEBUG) disetel ke `True`. Jika anda tidak mempunyai `django.contrib.staticfiles` di [`INSTALLED_APPS`](/id/3.2/ref/settings/#std-setting-INSTALLED_APPS),  anda dapat masih secara manual melayani berkas-berkas tetap menggunakan tampilan [`django.views.static.serve()`](/id/3.2/ref/views/#django.views.static.serve).

Ini tidak cocok untuk penggunaan produksi! Untuk beberapa strategi penyebaran umum, lihat [menyebarkan berkas tetap](/id/3.2/howto/static-files/deployment/).

Sebagai contoh, jika [`STATIC_URL`](/id/3.2/ref/settings/#std-setting-STATIC_URL) anda ditentukan sebagai `/static/`, anda dapat melakukan ini dengan menambahkan potongan berikut ke urls.py anda:

```
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # ... the rest of your URLconf goes here ...
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
```

> **Note**
>
> Fungsi pembantu ini hanya bekerja dalam suasana mencari kesalahan dan hanya jika awalan yang diberikan adalah lokal (sebagai contoh `/static/`) dan bukan URL (sebagai contoh `http://static.example.com/`).
>
> Juga fungsi pembantu ini hanya melayani folder [`STATIC_ROOT`](/id/3.2/ref/settings/#std-setting-STATIC_ROOT) sebenarnya; dia tidak menampilkan berkas-berkas tetap seperti [`django.contrib.staticfiles`](/id/3.2/ref/contrib/staticfiles/#module-django.contrib.staticfiles).

## Melayani berkas-berkas terunggah oleh pengguna selama pengembangan

Selama pengembangan, anda dapat melayani berkas-berkas media diupload-pengguna dari [`MEDIA_ROOT`](/id/3.2/ref/settings/#std-setting-MEDIA_ROOT) menggunakan tampilan [`django.views.static.serve()`](/id/3.2/ref/views/#django.views.static.serve).

Ini tidak cocok untuk penggunaan produksi! Untuk beberapa strategi penyebaran umum, lihat [menyebarkan berkas tetap](/id/3.2/howto/static-files/deployment/).

For example, if your [`MEDIA_URL`](/id/3.2/ref/settings/#std-setting-MEDIA_URL) is defined as `/media/`, you can do
this by adding the following snippet to your [`ROOT_URLCONF`](/id/3.2/ref/settings/#std-setting-ROOT_URLCONF):

```
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # ... the rest of your URLconf goes here ...
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
```

> **Note**
>
> Fungsi pembantu ini bekerja hanya dalam suasana mencari kesalahan dan hanya jika awalan yang diberikan adalah lokal (sebagai contoh `/media/`) dan bukan URL (sebagai contoh `http://media.example.com/`).

## Pengujian

Ketika menjalankan percobaan yang menggunakan permintaan HTTP sebenarnya daripada klien percobaan siap pakai (yaitu ketika menggunakan [`LiveServerTestCase`](/id/3.2/topics/testing/tools/#django.test.LiveServerTestCase) siap pakai) aset tetap butuh dilayani bersama sisa dari isi sehingga lingkungan percobaan memproduksi kembali satu yang asli setepat mungkin, tetapi `LiveServerTestCase` mempunyai hanya sangat dasar berkas tetap-melayani fungsi: Dia tidak tahu bahwa penemu fitur dari aplikasi `staticfiles` dan menganggap isi statis telah dikumpulkan dibawah [`STATIC_ROOT`](/id/3.2/ref/settings/#std-setting-STATIC_ROOT).

Karena ini, `staticfiles` mengemas [`django.contrib.staticfiles.testing.StaticLiveServerTestCase`](/id/3.2/ref/contrib/staticfiles/#django.contrib.staticfiles.testing.StaticLiveServerTestCase) milik dia sendiri, sebuah subkelas dari satu siap pakai yang mempunyai kemampuan untuk transparan melayani semua aset selama pelaksanaan dari percobaan ini dengan cara sangat mirip pada apa kami dapat di waktu pengembangan dengan `DEBUG = True`, yaitu tanpa mengumpulkan mereka menggunakan [`collectstatic`](/id/3.2/ref/contrib/staticfiles/#django-admin-collectstatic) pertama kali.

## Penyebaran

[`django.contrib.staticfiles`](/id/3.2/ref/contrib/staticfiles/#module-django.contrib.staticfiles) menyediakan kenyamanan perintah pengelolaan untuk mengumpulkan berkas-berkas tetap dalam direktori tunggal sehingga anda dapat melayani mereka dengan mudah.

1. Setel pengaturan [`STATIC_ROOT`](/id/3.2/ref/settings/#std-setting-STATIC_ROOT) ke direktori dari dimana anda ingin melayani berkas-berkas ini, sebagai contoh:

   ```
   STATIC_ROOT = "/var/www/example.com/static/"
   ```
2. Jalankan perintah pengelolaan [`collectstatic`](/id/3.2/ref/contrib/staticfiles/#django-admin-collectstatic):

   ```
   $ python manage.py collectstatic
   ```

   Ini akan menyalin semua berkas dari pelipat tetap anda kedalam direktori [`STATIC_ROOT`](/id/3.2/ref/settings/#std-setting-STATIC_ROOT).
3. Gunakan sebuah peladen jaringan dari pilihan anda untuk melayani berkas-berkas. [menyebarkan berkas tetap](/id/3.2/howto/static-files/deployment/) melingkupi beberapa strategi penyebaran umum untuk berkas-berkas tetap.

## Pelajari lagi

Dokumen ini melingkupi corak penggunaan dasar dan beberapa umum. Untuk melengkapi rincian pada semua pengaturan, perintah, etiket cetakan, dan potongan lainnya disertakan dalam [`django.contrib.staticfiles`](/id/3.2/ref/contrib/staticfiles/#module-django.contrib.staticfiles), lihat [the acuan berkas tetap](/id/3.2/ref/contrib/staticfiles/).