Поиск
Справочник

Команда base64: как закодировать и раскодировать текст или файл

base64 записывает любые данные — текст, ключ, картинку — буквами, цифрами и знаками + / =. Так двоичный файл можно вставить в настройки, письмо или переменную окружения, а потом вернуть его в исходном виде.

≈ 3 мин чтения
Содержание 9

Что сделать прямо сейчас

  1. Подключитесь к серверу — инструкция.
  2. Выполните printf '%s' 'hello' | base64. Ответ — aGVsbG8=.
  3. Выполните printf '%s' 'aGVsbG8=' | base64 -d; echo. Ответ — hello: base64 вернула исходный текст, а echo перевела строку после него.

Ключи base64

КомандаЧто делает
base64 файлкодирует файл и выводит результат на экран
base64 -d файлраскодирует файл
base64 -w 0 файлвыводит результат одной строкой, без переносов
base64 -d -i файлраскодирует, пропуская посторонние символы

Без имени файла base64 берёт то, что ей передали через знак |, как в примерах выше. Без ключа -w она переносит строку через каждые 76 знаков. При раскодировании переносы строк не мешают.

Перевод строки меняет ответ

Команда echo добавляет в конце перевод строки, и он тоже попадает в данные:

echo 'hello' | base64

Ответ — aGVsbG8K, а не aGVsbG8=. Для пароля или ключа API в настройках лишний символ — ошибка, поэтому строки кодируйте через printf '%s' или echo -n. Чем echo отличается от printf — Команды echo и printf.

Закодировать и вернуть файл

base64 -w 0 key.bin > key.txt
base64 -d key.txt > key-copy.bin

Первая команда пишет файл key.bin одной строкой в key.txt, вторая собирает из неё копию key-copy.bin. Чтобы убедиться, что копия не отличается, сравните контрольные суммы — Как проверить контрольную сумму файла.

Не пишите результат раскодирования в тот же файл, который читаете: bash очистит его раньше, чем base64 начнёт читать, — Перенаправление вывода.

base64 — не шифрование

Раскодировать строку base64 может любой, ключ для этого не нужен. Если пароль записан в настройках в base64, он открыт так же, как без неё. Файлы с такими строками защищайте правами доступа — Команда chmod.

Вариант для адресов и имён файлов

В стандартной записи base64 есть знаки + и /, которые в адресе сайта и в имени файла значат своё. Для таких мест есть вариант с - и _ вместо них:

printf '%s' 'hello' | basenc --base64url

Команда basenc входит в тот же набор программ coreutils, что и base64.

Ошибки и как их исправить

Что видноЧто значитЧто сделать
ошибка о неверных данных при -dв строке есть символы, которых нет в base64, или строку скопировали не целикомскопируйте строку заново или добавьте -i, чтобы пропустить посторонние символы
строка base64 не совпадает с ожидаемой, например aGVsbG8K вместо aGVsbG8=в данные попал перевод строки от echoкодируйте через printf '%s'
раскодированный файл пустойрезультат записан в тот же файл через >пишите в новый файл
строка разбита на несколькоперенос через 76 знаковдобавьте -w 0

Источники

Сверено 20 октября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше