Команда base64: как закодировать и раскодировать текст или файл
base64 записывает любые данные — текст, ключ, картинку — буквами, цифрами и знаками + / =. Так двоичный файл можно вставить в настройки, письмо или переменную окружения, а потом вернуть его в исходном виде.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу — инструкция.
- Выполните
printf '%s' 'hello' | base64. Ответ —aGVsbG8=. - Выполните
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 |
Источники
- Справка base64 для Ubuntu 24.04 — ключи -d, -i и -w, перенос через 76 знаков.
- Справка basenc для Ubuntu 24.04 — вариант --base64url.
- Исходный код coreutils 9.4: basenc.c — общий код base64 и basenc, разбор ключей и проверка данных при раскодировании.
- RFC 4648 — описание base64 и варианта для адресов.
Сверено 20 октября 2026 года.
Что почитать дальше
- Команды echo и printfвывод текста без перевода строки.
- Как проверить контрольную сумму файласравнить файл и копию.
- Перенаправление выводазнаки
>и|. - Команда chmodзакрыть файл от чужих глаз.