.CNF

Arquivo CNF

MySQL Configuration File
Fazer uma pergunta
RESPOSTA RÁPIDA

Um arquivo .cnf é quase sempre um arquivo de configuração do MySQL ou MariaDB chamado my.cnf. Ele define opções de servidor e cliente, como porta, diretório de dados e tamanhos de buffer. Abra e edite-o em um editor de texto simples como Notepad++ ou VS Code, e sempre faça um backup antes de fazer alterações - um erro de digitação pode impedir o serviço MySQL de iniciar.

Desenvolvedor: Oracle (MySQL) / MariaDB Foundation Categoria: Arquivos de Configuração Padrão aberto MIME: text/plain
ABRE EM Windows macOS Linux
Relacionado: .ICA · .DS_STORE · .WMZ · .CFG

Nesta página

19k+ extensões indexadas
Última revisão em Aug 21, 2026

Não tem certeza do que é seu arquivo?

Arraste qualquer arquivo para o nosso identificador - lemos apenas os primeiros bytes para nomear o formato.

Identificar um arquivo

O que é o formato de ficheiro CNF?

.cnf é um arquivo de configuração associado ao banco de dados relacional MySQL e ao seu fork compatível MariaDB. Arquivos .cnf armazenam opções de inicialização do banco de dados em texto simples, usando uma sintaxe estilo INI [section] key = value. O arquivo canônico é o my.cnf, normalmente localizado em /etc/my.cnf ou /etc/mysql/my.cnf em sistemas Linux e macOS. No Windows, o arquivo equivalente costuma ser nomeado como my.ini.

Arquivos .cnf definem parâmetros do banco de dados, como tamanho do buffer, configurações de cache, codificação de caracteres e opções de rede. Uma das configurações mais importantes é o parâmetro wait_timeout, que determina quanto tempo o servidor espera antes de fechar uma conexão inativa - isso é especialmente importante para bancos de dados grandes e aplicações que usam consultas complexas. Outras diretivas controlam o pool de buffers do InnoDB, o log binário e os limites máximos de conexão.

O MySQL lê os arquivos de opções de um conjunto documentado de caminhos em ordem, com as configurações nos arquivos posteriores substituindo as dos anteriores. As diretivas !include e !includedir permitem dividir a configuração em vários arquivos .cnf.

O MySQL é o sistema de gerenciamento de banco de dados relacional mais popular, amplamente utilizado em sites, aplicações corporativas e implementações em nuvem. É uma tecnologia gratuita e de código aberto mantida pela Oracle. O MariaDB, um fork da comunidade, utiliza a mesma sintaxe de arquivo de opções .cnf e é igualmente prevalente em servidores Linux.

Segurança e proteção

RISCO: MEDIUM

O arquivo é seguro para leitura, mas aplicam-se duas precauções reais. (1) Risco de edição: uma opção inválida ou erro de digitação em [mysqld] é uma causa comum de «MySQL não inicia» - faça backup do arquivo, altere uma opção por vez e valide antes de reiniciar. (2) Exposição de credenciais: arquivos .cnf (especialmente ~/.my.cnf) geralmente armazenam nomes de usuário e senhas de banco de dados em texto claro, portanto, restrinja as permissões do arquivo (chmod 600) e nunca o envie para um repositório público. Trate arquivos de ajuste «my.cnf otimizados» baixados com cautela - verifique se as opções adequam-se à RAM e à versão do seu servidor.

Detalhes do formato

em resumo
NOME COMPLETOMySQL Configuration Filetambém conhecido como my.cnf, MySQL option file
DESENVOLVEDOROracle (MySQL) / MariaDB Foundationdesde MySQL option files, mid-1990s (my.cnf on Unix; my.ini on Windows)
TIPO MIMEtext/plain
TIPOArquivo de opções estilo INI em texto simples ([section] key = value)
PADRÃOAberto · livre de royalties
Esta extensão também é usada por…
  • Arquivo de configuração / certificado OpenVPN - Algumas configurações de OpenVPN e OpenSSL usam .cnf para configurações de config ou solicitação de certificado (ex: openssl.cnf).
  • Configuração do emulador de arcade MAME - O MAME e alguns emuladores gravam arquivos de configurações .cnf por jogo.
  • Configuração genérica de aplicativos - Vários programas reutilizam .cnf como um arquivo de configurações de texto simples não relacionado ao MySQL.

Programas que abrem arquivos CNF

Windows3 apps
Notepad Código aberto Clique com o botão direito > Editar com Notepad++ para ler/editar as opções no estilo INI com ajuda de sintaxe. Nota: no Windows, o arquivo geralmente é o my.ini.
Visual Studio Code Gratuito Abra o .cnf para editar com realce de sintaxe INI; bom para configurações maiores e inclusões.
MySQL Server / Workbench Gratuito O próprio MySQL lê o .cnf na inicialização do serviço; o editor de Arquivo de Opções do Workbench expõe muitas configurações via GUI em vez de edição manual.
macOS3 apps
TextEdit Integrado Abra o .cnf, escolha Formatar > Converter para Texto Simples para que ele permaneça como texto simples ao salvar.
MySQL Server Gratuito Lê /etc/my.cnf ou ~/.my.cnf na inicialização (as instalações via Homebrew variam o caminho).
Visual Studio Code Gratuito Abra o .cnf para editar com realce de sintaxe INI; bom para configurações maiores e inclusões.
Linux3 apps
nano / vim Código aberto Edite no terminal: sudo nano /etc/mysql/my.cnf - a forma usual em servidores. Faça backup primeiro e reinicie o mysqld para aplicar.
MySQL Server / MariaDB Código aberto O mecanismo de banco de dados lê o arquivo na inicialização; valide com mysqld --validate-config (MySQL 8) antes de reiniciar.
GNOME Text Editor / gedit Código aberto Abra o .cnf para ler/editar no desktop.

Detalhes técnicos

especificação profunda
Formato de arquivoArquivo de opções estilo INI em texto simples sem codificação binária
Estrutura de sintaxeCabeçalhos de seção como [mysqld] ou [client], cada um contendo linhas de opção key = value
Codificação de caracteresASCII / UTF-8
Tamanho de arquivo típico1 KB - 30 KB
Nome de arquivo canônicomy.cnf no Linux e macOS; my.ini no Windows (mesma sintaxe, nome diferente)
Caminhos de busca padrão/etc/my.cnf, /etc/mysql/my.cnf, ~/.my.cnf - lidos na ordem documentada; o arquivo posterior substitui o anterior
Grupos de seção[mysqld], [client], [mysqldump], [mysqld_safe], [mysql]
Diretivas de inclusão!include e !includedir permitem que administradores dividam a configuração em vários arquivos
Sintaxe de comentárioLinhas começando com # ou ;
Consideração de segurançaPode conter senhas de banco de dados em texto simples - proteja com chmod 600 em sistemas Unix
Tipo MIMEtext/plain
Assinatura de arquivoNenhuma - identificado por cabeçalhos de seção estilo INI como [mysqld], não por uma assinatura de byte binário
Produtos compatíveisMySQL 5.x / 8.x e MariaDB 10.x / 11.x - ambos usam sintaxe de arquivo de opções idêntica
Principais opções configuradasinnodb_buffer_pool_size, wait_timeout, max_connections, character-set-server, bind-address
CompressãoNenhuma - sempre armazenado como texto simples não compactado
DesenvolvedorOracle Corporation (MySQL) e a MariaDB Foundation
LançadoMySQL option files, mid-1990s (my.cnf on Unix; my.ini on Windows)
Versão mais recenteOngoing - same INI option-file syntax across MySQL 8.x and MariaDB 11.x
Padrão abertoSim · livre de royalties
Especificaçãodev.mysql.com

Conversões de CNF

Perguntas e Respostas da Comunidade

perguntado por usuários
Faça uma pergunta rápida
Obtenha ajuda de pessoas que trabalham com arquivos CNF. Seja específico - inclua seu sistema e a versão do software.
Não é necessário criar conta · respostas geralmente em um dia

Ainda não há perguntas - seja o primeiro a perguntar sobre arquivos CNF.

Perguntas frequentes

O que é um arquivo .cnf?
No MySQL/MariaDB, é o arquivo de configuração («opção»), geralmente chamado de my.cnf, que define as opções do servidor e do cliente, como porta, diretório de dados, tamanhos de buffer e conjunto de caracteres padrão. É um texto simples no formato INI.
Como abro e edito um arquivo .cnf?
Abra-o em um editor de texto simples ou de código - Notepad++ ou VS Code no Windows, nano/vim em servidores Linux (sudo nano /etc/mysql/my.cnf), TextEdit (texto simples) no Mac. Faça um backup primeiro e, em seguida, reinicie o serviço MySQL para aplicar as alterações.
Onde o arquivo my.cnf do MySQL está localizado?
Os locais comuns são /etc/my.cnf, /etc/mysql/my.cnf e ~/.my.cnf no Linux/macOS; no Windows, geralmente é o my.ini no diretório de dados ou de instalação do MySQL. Execute «mysqld --help --verbose» para ver a ordem de busca.
Por que o MySQL não inicia após eu editar o my.cnf?
Quase sempre é uma opção inválida ou com erro de digitação, ou uma opção não suportada pela versão do seu servidor. Restaure seu backup ou comente a última alteração; no MySQL 8, execute «mysqld --validate-config» para encontrar a linha problemática.
Qual é a diferença entre my.cnf e my.ini?
Nenhuma no formato - ambos são o mesmo arquivo de opções do MySQL no estilo INI. my.cnf é o nome para Unix/Linux/macOS; my.ini é o nome para Windows.
É seguro armazenar minha senha no .my.cnf?
É conveniente para ferramentas de linha de comando, mas a senha fica em texto simples. Restrinja as permissões (chmod 600 ~/.my.cnf) para que apenas o seu usuário possa lê-lo, e nunca compartilhe ou envie o arquivo para repositórios.

Referências

1MySQL Reference Manual - Using Option Filesdev.mysql.com
2MariaDB - Configuring MariaDB with option filesmariadb.com

Continue explorando

em todo o banco de dados

Principais extensões desta semana

1.AQQAQQ Instant Messenger File
2.CRDOWNLOADChrome Partial Download File
3.PARTPartial Download File
4.JPGJPEG Image
5.MDMarkdown Document
6.EXEWindows Executable (Portable Executable)
7.RPMSGRestricted Permission Message
8.BINCD/DVD Disc Image (BIN/CUE)
9.DATProgram Data File (generic)
10.EMLE-Mail Message (RFC 822 / MIME)

Extensões relacionadas

.ICACitrix Independent Computing Architecture file
.DS_STOREmacOS Finder Desktop Services Store (.DS_Store)
.WMZWindows Media Player Skin
.CFGConfiguration File
.LICLicense File
.CONFConfiguration File

Ferramentas de arquivo gratuitas

Um identificador de arquivos e conversor de imagens no navegador - tudo funciona no seu dispositivo.

Abrir a caixa de ferramentas

Navegar por extensões de arquivo A-Z