Chức năng tệp configuration.yaml trong Home Assistant và lý do bạn nên quan tâm

Tác giả Skynet, T.Một 06, 2026, 09:00:10 CHIỀU

« Chủ đề trước - Chủ đề tiếp »

0 Thành viên và 1 Khách đang xem chủ đề.

Bạn sẽ không cần đến nó cho đến khi bạn thực sự cần.

Mặc dù có khả năng tùy chỉnh gần như vô hạn, Home Assistant thoạt nhìn có vẻ khá đơn giản. Tuy nhiên, đôi khi bạn có thể cần thiết lập các tích hợp hoặc thực hiện các thay đổi thủ công, và trong những trường hợp đó, bạn có thể được hướng dẫn đến configuration.yamltệp tin cần thiết.


Dưới đây là chức năng của tập tin đó, cách chỉnh sửa nó và lý do tại sao bạn có lẽ không cần phải quá lo lắng về nó.

1. Tệp này configuration.yamlphục vụ nhiều mục đích

Tệp này configuration.yamllà một tập hợp các hướng dẫn thường nằm trong configthư mục trên máy chủ Home Assistant của bạn. Phần mở rộng YAML đề cập đến loại định dạng được sử dụng trong tệp (ban đầu được cho là viết tắt của Yet Another Markup Language, sau đó được điều chỉnh thành YAML Ain't Markup Language).

Định dạng YAML được thiết kế để trở thành mã dễ đọc đối với con người, sử dụng các quy tắc đơn giản như thụt lề. Nó được sử dụng rộng rãi trên toàn bộ nền tảng Home Assistant, ví dụ, trong các tự động hóa và tập lệnh. Mục tiêu thiết kế là để dễ tiếp cận, do đó định dạng không phải là rào cản, mặc dù bạn vẫn cần hiểu các khái niệm cơ bản của Home Assistant như thực thể và giá trị.

Có thể nói, những lý do chính khiến bạn muốn thay đổi tệp này configuration.yamllà để gọi một số quy trình tự động hóa nhất định hoặc thay đổi cách thức hoạt động của Home Assistant bên ngoài giao diện người dùng chính.


Phần lớn các tích hợp bạn sẽ gặp khi sử dụng nền tảng này đều được thêm vào thông qua giao diện người dùng chính, với các bảng cấu hình tiện dụng và quy trình thiết lập dễ dàng. Nếu bạn quyết định thử cách khác và cài đặt các tích hợp từ bên ngoài bản phát hành chính thức của Home Assistant, ví dụ như từ Home Assistant Community Store, bạn có thể cần phải thực hiện một số thay đổi đối với tệp configuration.yamlcấu hình để các tích hợp này hoạt động khi máy chủ khởi động.

Việc này có thể đơn giản như thêm một vài dòng mã mà bạn có thể sao chép và dán, hoặc có thể yêu cầu một quy trình thiết lập phức tạp hơn, trong đó bạn phải xác định các tham số để tích hợp hoạt động như mong muốn. Tôi từng thêm một tích hợp tập trung vào giao thông công cộng vào bảng điều khiển Home Assistant của mình, điều này yêu cầu tôi phải liên kết với API cần thiết và tham chiếu đúng dữ liệu điểm dừng và hành trình trong tệp YAML.

Một công dụng khác của configuration.yamltập tin này là khi thực hiện các thay đổi đối với cách thức hoạt động của Home Assistant. Một ví dụ điển hình là tùy chỉnh thanh bên để tạo các lối tắt đến các phần khác nhau của nền tảng.

Tệp này cũng được sử dụng để gọi các tệp YAML khác chứa các tập lệnh, tự động hóa, cảnh và chủ đề giao diện người dùng của bạn. Mặc dù không cần thiết phải thay đổi chúng đối với hầu hết các trường hợp, bạn vẫn có thể thêm các tệp của riêng mình nếu muốn.

2. Chỉnh sửa tệp configuration.yaml

Bạn có thể chỉnh sửa configuration.yamltệp bằng trình soạn thảo văn bản thông thường, miễn là bạn có quyền truy cập vào nó. Hầu hết mọi người sẽ tìm thấy nó trong /config/thư mục trên máy chủ của họ, trong khi người dùng Docker sẽ tìm thấy nó trong /homeassistant/thư mục core.

Nếu bạn đang chạy Home Assistant trên máy chủ như Raspberry Pi hoặc sử dụng máy ảo để chạy Home Assistant trên một hệ điều hành khác, việc truy cập tệp này có thể khá khó khăn. May mắn thay, có một cách dễ dàng để giải quyết vấn đề này bằng cách sử dụng một tiện ích bổ sung có tên là File editor.

Bạn có thể cài đặt tiện ích bổ sung Trình chỉnh sửa tệp trong Cài đặt > Tiện ích bổ sung bằng cách nhấp vào nút "Cửa hàng tiện ích bổ sung" và tìm kiếm nó. Sau khi cài đặt xong, hãy mở Trình chỉnh sửa tệp trong Cài đặt > Tiện ích bổ sung > Trình chỉnh sửa tệp > Mở giao diện web. Tôi đã tạo một phím tắt cho việc này để thao tác dễ dàng hơn.


Mặc định, configuration.yamltệp của bạn sẽ được mở đầu tiên. Tại đây, bạn có thể thêm bất kỳ dòng nào bạn muốn và sử dụng chú thích (#) phía trên mỗi dòng để thêm mô tả, giúp bạn biết các phần khác nhau làm gì. Khi hoàn tất, hãy nhấp vào nút bút màu đỏ "Lưu" ở cuối màn hình.

Để áp dụng bất kỳ thay đổi nào bạn đã thực hiện trong configuration.yamltệp của mình, bạn cần khởi động lại Home Assistant. Bạn có thể thực hiện việc này thông qua menu Cài đặt bằng cách nhấp vào "ba dấu chấm" ở góc trên bên phải của trang và chọn "Khởi động lại Home Assistant".

Một lựa chọn khác là chia sẻ /homeassistant/thư mục của bạn thông qua mạng bằng cách cài đặt tiện ích bổ sung chia sẻ Samba và kết nối với máy chủ của bạn thông qua một máy tính khác trên mạng. Từ đó, bạn có thể mở configuration.yamltệp bằng trình soạn thảo văn bản và thực hiện bất kỳ thay đổi nào bạn muốn.

3. Đừng lo lắng về điều đó cho đến khi bạn cần đến nó

Như đã đề cập, configuration.yamlbạn sẽ không cần tương tác với tệp này cho đến khi đột nhiên nhận thấy mình cần đến nó. Các tích hợp bạn sẽ sử dụng hàng ngày được xây dựng dựa trên giao diện người dùng đơn giản và không cần phải được gọi thủ công bằng tệp này.

Thỉnh thoảng, bạn có thể gặp phải một số tích hợp phức tạp cần thiết để tích hợp một thiết bị hoặc dịch vụ chuyên biệt vào máy chủ của mình. Việc phải chỉnh sửa file configuration.yamlkhông có nghĩa là tích hợp đó không đáng để bạn bỏ thời gian ra, và bạn không nên ngại sử dụng nó.

Như mọi khi, hãy đảm bảo bạn đã thiết lập sao lưu Home Assistant để có thể hoàn tác bất kỳ thay đổi không mong muốn nào và khôi phục máy chủ nếu cần.